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Documentation 
Conventions 



Introduction 



This document describes the release and installation of OS/MP 4.1C. 
OS/MP 4.1C is a "full" installation that you can use to: 

□ install OS/MP 4. IC on a Solboume system 

n add support to a server for an OS/MP 4. IC client 

□ repartition a hard disk drive 

This release applies to the following Solboume architectures: SeriesS, Series5E, 
Series6, and Series S4000 systems. In these release notes, the term "Series S4000," 
or simply "S4000," refers to all Solboume S4000, S4000DX, and S3000 systems; 
"Series5" refers to both Series5 and SeriesSE architectures; also "Series6" refers to 
both the 33 and 50 mhz Series6 speeds. 

OS/MP 4.1C offers basic binary application compatibility with SunOS 4.1.2 and 
4.1.3. and prior OS/MP releases. 

• * • NOTE * * * 

Some layered products running on OS/MP 4.1 C require revision upgrades. Refer 
to ' 'OS/MP 4.1C Enhancements and Miscellaneous Software Information ' 'for de- 
tails. 



In the body of this document, commands and file names are presented in boldface 
and command parameters for which you substitute a value are italicized. User input 
instmctions and examples are presented in a constant width font. In these notes, the 
following convention is followed: 

□ Information displayed by the system is given in normal constant 
width. 

□ Information you enter is displayed in bold constant width. 

D Variables for which you substitute a value are shown in oblique 
constant width. 
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Definitions 



local A device that is physically connected to the system being installed. For ex- 
ample, a local disk drive. 

remote A device that is physically connected to a system other than the system be- 
ing installed. For example, a remote tape drive. 

package The components of a distribution are referred to as packages. Examples 
of packages are FORTRAN 1.4, X Windows, and Solboume OS/MP Optional 
Software for S4000. 

ramdisk image The ramdisk image is a special UNIX kernel with a built-in RAM 
disk that contains the installation software. 

server A system that is on a network and may provide NFS disk services. 

client A system that uses NFS services provided by another system. A diskful sys- 
tem with root(/), swap, and /usr on a local disk. 

diskless A system whose root(/), swap, and /usr filesystems are provided by a 
server, instead of a local disk. 

dataless A system whose /usr filesystem is on a remote disk and whose root (/) 
filesystem and swap disk partition are on a local disk. 

standalone A system that has no networking. It also does not depend on a server 
for its root, swap, or /usr filesystems. 

filesystem A set of files and directories that reside on one disk partition. The term 
is also used to refer to the swap area, even though the swap area does not actually 
contain files and directories. 

hostnumber The host portion (the last number of a class C address) of the Internet 
Protocol address. For example, if the Internet address is 192.1.3.42, the hostnum- 
ber is 42. 



Physical Elements of this 
Release 



This release contains the following items: 

Table 1. Physical Elements of the OS/MP 4.1C Release 



Part Number 


Description 


106550 
106552 
106507 


1/4-inch QIC- 150 OS/MP 4.1 C tape, or 
8mm Exabyte OS/MP 4.1C tape, or 
CD-ROM OS/MP 4.1C disk 


106562 
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Contents of the 
OS/MP 4.1C 
Release Media 



Table 2. Contents of OS/MP 4.1C Tape 



FUe 

# 


File 


Format 


Size 

(KB) 





Table of Contents 


dd 


2 


1 


Package Description File for Full 4.1C installation 


dd 


2 


2 


Series5 Installation Kernel 


dd 


6826 


3 


Series6 Installation Kernel 


dd 


6882 


4 


S4000 Installation Kernel 


dd 


6479 


5 


Tools files 


tar 


288 


6 


Miniusr 


dd 


18432 


7 


Root files 


tar 


6856 


8 


Series5 kvm files 


tar 


11632 


9 


Series6 kvm files 


tar 


11760 


10 


S4000 kvm files 


tar 


10224 


11 


Usr files 


tar 


33384 


12 


debugging files 


tar 


2888 


13 


games files 


tar 


3136 


14 


man files 


tar 


7504 


15 


networking files 


tar 


1096 


16 


graphics files 


tar 


1784 


17 


security files 


tar 


320 


18 


sunview_programmers files 


tar 


1848 


19 


sunview_users files 


tar 


3144 


20 


system_v files 


tar 


3992 


21 


text files 


tar 


728 


22 


versatec files 


tar 


5960 


23 


uucp files 


tar 


608 


24 


rfs files 


tar 


912 


25 


shlib_custom files 


tar 


1376 


26 


tli files 


tar 


48 
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Customer Support 
Information 



Customer Support Information 



If you have problems installing or using the features included in the Solbourne 
OS/MP 4.1C release, call the Solbourne toll free support number, 1-800-447-2861, 
if you are within the United States. Customers outside the U.S. should call their lo- 
cal Solbourne representative. If you have purchased a support contract that in- 
cludes support for OS/MP 4.1C from Solbourne, this service is provided. When 
you call, please be prepared to give the following information about your system: 

O Model number (such as Series6/902 or S4000) 

D Serial number 

a Solbourne OS/MP release number (4. 1 C) 

The system's model number and serial number can usually be determined using the 
eeprom(8) command, as in the following: 



( # /usr/ete/eeprom MODEL SERXAL 



J 



To check the Solbourne OS/MP release number, enter the cat command as shown 
below: 



f^ cat /ete/iaotd 

OS/MP 4.1C Export (GENEHIC/root)#0: Mon Oct 25 21:09:241993 
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SOLIS - Solbourne 
On-Line Information 
System 



Following is a description of the various ways customers obtain the latest patches 
for the Solbourne operating system and unbundled software products. 

SOLIS, Solbourne' s On-Line Information Service, allows users access to available 
Solbourne patches via email. 

The Information Service is based on the public domain "discussion listserv" pro- 
gram written by Ariastasios Kotsikonas. 

To access the service, simply email solis@solbourne.com. Command keywords 
are used in the body of the mail message (leave the subject line blank).tp invoke 
the desired operations of the Information Service program. Requests .are not case 
sensitive. 

O To get a listing of recognized requests: 

help 

example; 

mail 8oli8@solbourne*coin 

- Subject: \ ' - 

help 

O To obtain an index of the files in a specified archive: 
index, [archive .\ path-to-archive] 
example: ' 

mail solii!?$solbounie>coift 

Subject: 

index patche@/4.XC 

□ To obtain a copy of the actual index file which gives a brief description of each 
patch: 

example: 

mail solisdsolboume * com 

Subject: 

get patches/4 *1C index 
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To request a file from a specified archive: 

get Karchive \ path-to-archlve> <file> ipartsl 

example: 

mail solisdsiolboume « com 

Sub j ect : 

0et patches/4 *iC pd3050601 

To request all patches from a specified archive: 
example: 

mail solis^sol&ouxma , com 

Subject: 

get patcliea/4,ic all 

An archive file will be in one of two formats: an ascii file or multiple parts 
which should be concatenated (removing mail headers first), uudecoded, and 
tar extracted. 

Currently available archives are: OS/MP 4. IB, 4.1C, c-H-, openwindows, 
pdb2.2,x2.1,x3.0. 

If you have comments or other categories of archives you would like to see 
available on the Information Service, please email solis- 
admin @ solbourne.com . 
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Patches via FTP 



Patches are also available via anonymous ftp from the Solboume archive machine, 
ftp.solbourne.com (internet address 141.138.2.2). Each patch directory contains 
an index file and the individual patches which are in a compressed tar file format. 
Some patch directories also contain README files which provide specific in- 
structions for that patch directory. The Solpatch utility MUST be used to install all 
OS/MP 4. IC patches. 

Directions: 

ftp ftp.solbotume.coia 

login: anonymous 

passwd: your, email .address (i,e, user@domain.orig} 

f tp> cd pub/ support 

ftp> Is (for listing of available patch directories) 
£tp> cd [desired patch directory] 
£tp> bin (to put in binary transfer mode) 
f tp> get [desired patch] 
uncompress patch. tar. Z 
tar 3cvf patch 
^ftp> bye ^ 



Example: 



ready. 



ftp ftp.solboume.com 

Connected to Solbourne. 
220 solbourne FTP server (OS/MP 4,1A,2) 
Name (solbourne: user): anonymous 

331 Guest login ok, send ident (user@host) as password. 
Password: user@domain.orig 

230 Guest login ok, access restrictions apply. 
£tp> cd pub/ support /0S4.1C 
250 CWD command successful. 
£tp> bin 

200 Type set to I, 
ftp> get p93050601.tar.Z 
200 PORT command successful. . 

150 Binary data connection for p93050601. tar.Z 
(141.138,5.77,1877) (26097 bytes) - 
226 Binary transfer complete. 
local: p93050601..tar.Z 
remote: p93050601. tar .Z 

26097. bytes received in 0.2 seconds (1.3e+02 Kbytes/s) 
uncompress p93050601.tar.Z 
tar 3cvf p93050601 
>^ftp> bye ' 
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Patch Information via 
Solboume News Group 



The solboume.info USENET mailing list is also updated regularly when patches 
are released. Patches cannot be obtained from the news group but it is a good 
source for finding out when patches are released. 

To subscribe to this news group: 

email: solbourne-info-request@acsu.buffalo.edu, and ask to be placed on the 
subscribers list. 

If none of the above options is available to you, please contact National Technical 
Support at 800-447-2861. 
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Solpatch 



Solpatch is a software utility that provides easy installation, tracking, and removal 
of official Solboume released patches for the OS/MP and other unbundled software 
products. 

Solpatch was available as apatch in OS/MP 4.1B and is bundled into OS/MP4.1C. 
To use Solpatch: 

1, Become root 



Make sure that the PATH variable for the root login account contains the 
following directories: 

• /usr/bin 

• /usr/sbin 

• /usr/sadm/install/bin 

To invoke solpatch: 



|[lililllllliili^^^^^ 



patch_spooIdir is where the patches reside and patchjogfile is where 
solpatch logfile resides (default is /var/adm/patch_logfile). These arguments 
can also be specified by setting the environment variables 
PATCH_SPOOLDIR and PATCH_LOGFILE. 

Refer to the solpatch man page for additional information. In addition, on-line 
help is available when running Solpatch. 
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OS/MP4.1C 
Enhancements 



OS/MP 4.1C Enhancements and 
Miscellaneous Software Information 



This section explains the enhancements provided by OS/MP 4.1C and other useful 
software information such as kernel reconfiguration and setting BootROM envi- 
ronment variables. 



OS/MP 4.1C incorporates many improvements. These improvements were ob- 
tained by multithreading kernel subsystems that were previously single-threaded, 
improving already multithreaded subsystems, and optimizing critical code paths. 



Clock Changes 



In looking at customer performance problems a large degree of variability in per- 
process user and system time was noted. This discrepancy was caused by the way 
clock ticks were processed. For each clock tick from the hardware, the software 
"relayed" the tick to all other CPUs. When a tick was received it charged the pro- 
cess running for all the time that had elapsed since the last tick was received on that 
processor (based on whether it was in system or user mode when the tick was de- 
livered). Because of some of the SPL problems detailed below a processor could 
miss many relayed ticks in a row and then charge all the missed time as a lump sum 
to either system or user. Also, there was no synchronization of missed ticks across 
a context switch in prior OS/MP releases, which could cause the wrong process to 
be charged. 
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All of these problems have been fixed in OS/MP 4.1C. A new method of dealing 
with clock ticks which does not require relaying clock ticks to slaves is used. The 
processor which receives the hardware clock tick does all the billing for all CPUs. 




CPUO 



CPU1 



CPU2 



CPUS 



200usec 



4.1B clock processing 



10msec 



200usec 




4.1C clock processing 



Also, the micro-second timer on Series6 boards is now used to provide high reso- 
lution time (to lusec) to user level applications; For example, 4. IB allows time res- 
olution to the 10msec level. For other CPU types, the 10 msec resolution still ap- 
plies. 

LEDs 

One side effect of all the "clock tick" changes is that the CPU board LEDs no 
longer "bounce" (or toggle) the same. "Bouncing" is an interesting side effect of 
system behavior that was commonly used to verify normal operations; this pattern 
has changed. Now, bouncing LED displays only happen when clock ticks are re- 
ceived by a CPU. Since clock ticks are not received by all CPU's, not all CPUs will 
have bouncing LEDs. 

The "F4" code displayed on a GPU running OS/MP 4.1B indicated that the CPU 
was idle on a process. OS/MP 4.1C no longer uses "F4" for idle states, and now 
displays a decimal point instead. 
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fsck Enhancement 



The utility fsck(l)'s preen mode has been modified to avoid aborting due to insuf- 
ficient swap space availability. Preen mode minimizes file system checking time 
by looking at file systems in parallel. This results in several instances of fsck(l) 
running at once, one per file system being checked. The memory requirements for 
each fsck(l) depend on the size of the file system involved. The previous behavior 
was that a memory allocation failure would cause fsck(l) to believe the file system 
was corrupted in a way that can not be corrected manually, causing the system to 
sit in single-user mode until a manual check of the file systems has been done. The 
new version of fsck(l) notices when a memory allocation failure occurs when 
checking a particular file system. The number of checks to be done in parallel is 
reduced, and the checks are repeated for the file systems that weren't able to be 
checked due to memory shortages. This procedure is repeated until all file systems 
have been checked, or the number of checks to run at once reaches zero. In the latter 
case, there is not sufficient swap space to check a particular file system at all when 
in preen mode. 

When the number of parallel checks to run is reduced, fsck(l) prints the message: 



fsck: concurrency reduced to N due to memory 
restrictions 



If the concurrency value is reduced many times, this is a good indication that the 
primary swap partition of the system is too small. It should either be enlarged, or a 
different, larger partition should be named in the BootROM environment variable 
DEFAULTDUMP. 



Hardware Clock 
Synchronization 



Using a network time synchronization utility can cause erratic time behavior under 
OS/MP 4. IC. This happens because the kernel, by default, attempts to synchronize 
with the hardware time-of-day clock, rather than forcing the hardware clock to 
agree with the kernel's idea of what time it is. One example of a utility to provide 
synchronized time across a network is xntpd, which is part of a program suite that 
implements the Network Tirne Protocol (it is available via the Internet). 

You can disable the kernel synchronization with the hardware clock by using one 
of the following three methods. 

# adb -w /vxntmise /dev/kmem 

not core file = /dev/kmem 
dosynctodr/WO 

_dosynctodr: 0x1 = 0x0 
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It may also be set in the kernel config area, so that all new kernels will be built with 
the desired value: 

/■" • ' ■' ■ >^ 

# cd /Sys/kbuS/OBJ 

# adb -*w clock. o 

,dosynctodr?wO 

_dosynctodr: 0x1 = 0x0 

# Cd ,*/K£RNEti 

# iQalco 

# mv /vmunix /vmunix*old 

# cp vmunix /vmimix 

# shutdown «r +5 To install a new kernel 

Finally, it can be set at boot time, avoiding any problems with installing any pos- 
sible future patches to /sys/kbus/OBJ/clock.o by losing the modification to do- 
synctodr. This can be accomplished by adding the following line near the end of 
/etc/rclocal: 

recho ^^dosynctodr/WO" | adb -vr /vxnunix /dev/kmem ^ 

It will result in these two lines being printed to the console during boot: 



not, core file = /dev/kmem 
_dosynctodr: 0x1 = 0x0 



This can be considered a reminder that hardware clock synchronization has been 
disabled. It can be suppressed by putting a slightly different command into 
/etc/rclocal: 

l ^/dev/null 2>&1 ' 
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Support for up to 768 

Pseudo-Terminals 

(ptys) 



The system can now support up to 768 pseudo-terminals (ptys). This support in- 
cludes the following modifications: 

D The system utilities that use ptys (in.rlogind(8), script(l), in.telnetd(8), and 
rexd(8)) now take advantage of the greater available number of ptys. 

□ The file /dev/MAKEDEV can create all of the relevant /dev/pty* and 
/dev/tty* entries, using MAKEDEV ptyi\7; where iV^is between and 47 
inclusive. Each i\7' number represents 16 devices. 

□ The macro nonuser() in the C header file /usr/include/utmp.h will scan all of 
the possible tty names. 

□ Entries have been added to /etc/ttytab for all of the new tty names. 

The GENERIC kernel only supports 48 ptys. To enable kernel support for more, 
the appropriate config file in /sys/kbus/conf or /sys/idt/conf must be modified. 
Modify the line: 

(^pseudo-device pty # pseudo-tty's, also needed for SunView^ 
to list the number of ptys wanted. For instance, to support 128 ptys: 

/^pseudo-device pty 12 8 # pseudo-tty's, also needed for ^ 

[ SunView I 

Then reconfig and rebuild the kernel, and reboot the system: 



# cd /sys/Jcbus/conf 

# cp GENERIC MANYPTYS 

# vi MANYPTYS (change the pty line as described above} 

# config MANYPTYS 

# cd . . /MANYPTYS 

# make 

# mv /vmaxiix /vnruniac.old 

# cp vmtinix: /vmuxiix 

# shutdown "X +5 To install a new kernel 
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SPL Changes 



Processor Affinity Changes 



oncpu Command 



SPLs (Set Priority Level) in the kernel which were trying to block all device inter- 
rupts were also blocking clock ticks. This was a result of the way the System Board 
and MCAB delivered VME level 7 interrupts. To resolve this problem, support for 
VME level 7 interrupts was dropped, allowing the kernel to block all device inter- 
rupts without preventing clock ticks from being delivered. 

Another optimization made in 4.1C was to keep a shadow copy of the processor 
priority in the per-cpu structure, avoiding the overhead of reading this value from 
the hardware. Also, unnecessary reads of the priority level were eliminated alto- 
gether. 



Processor affinity refers to the tendency of a process to keep running on the same 
CPU rather than wandering from one to another at each context switch. With a 
16Mb cache there is potentially a lot of data cached on the Series6 L3 cache. If a 
process is allowed to wander at will it can generate significant Kbus traffic as its 
working set tries to follow it. OS/MP 4. IB had algorithms which prevented process 
migration if the number of runnable processes was less than or equal to the number 
of CPUs, or if the number of runnable processes was much bigger than the number 
of cpus. OS/MP 4.1C incorporates algorithms to maintain good process to proces- 
sor affinity when the load is in the middle; the number of runnable processes is 
greater than the number of CPUs, and less than 4 times the number of CPUs. 

The effectiveness of processor affinity can be monitored with vmstat -p. This dis- 
plays the ratio of context switches to a process which last ran on this cpu, to the 
total number of context switches. 

Processor affinity can be disabled by patching the kemel variable 
enable_pam_affinity to a value of zero and rebooting: 



# adb -w /vmunix 

enable_jpanuaf f ini ty ?W0 

_enafole_oam_af finity: 

AD 

# reboot 



"^ 



0x1 



0x0 



The oncpu command is new in OS/MP 4. IC. This command lets you control which 
processors a process can run on in a multi-CPU system. By using oncpu to force 
certain critical processes to run on particular CPUs, you can improve caching char- 
acteristics and overall system performance. 



Refer to Appendix A for the oncpu man page. 
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Page Allocation Changes 



Reduction of False Sharing 



SCSI Command Queueing 
Changes 



The selection of pages to allocate to a process when a large direct indexed cache is 
present can result in unnecessary physical aliases in the cache if all free pages are 
kept on a single free list. Maintaining a free list of pages for each page aliases in 
the cache and managing alias allocations on a per process basis can significantly 
reduce misses in the cache, thus improving performance and reducing traffic on the 
system bus. This technique, called "bin hopping" is described in KESS^ 



False sharing occurs when private per-cpu data structures are allocated in the same 
cache block. False sharing results in unnecessary bus traffic. The following areas 
of code were modified to minimize false sharing: Global File Table allocation, sta- 
tistics, and scheduling. 



To achieve maximum performance with the latest generation SCSI-2 disks, host- 
adaptor drivers now support SCSI-2 tagged command queueing. SCSI-2 command 
queueing allows multiple commands to be issued to a drive at the same time. Each 
of these commands has an associated "tag" which allows the drive and the host 
driver to synchronize their operations. Tagged commands address many of the 
same problems on the per-drive basis that SCSI-l's disconnect-reconnect feature 
addressed on a per-SCSI bus basis. The benefits of tagged commands are: 

□ The latency from the end of one operation to the beginning of the next is 
minimized. 

□ Tagged commands allow the drive to implement 2-dimensional seek 
optimizations (cylinder distance, rotational distance), completing commands 
out of order while preserving the semantics. 



' KESSLER, HILL: Page Placement Algorithms for Large Real-Indexed Caches. ACM Transactions on 
Computer Systems, Vol 10, No. 4, November 1992, Pages 338-359 
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Testability and Reliability 
Changes 



Parallel Networking 



Parallel Softcalls 



New testability features have been added to 4.1C: 

O Software was added to generate SECC and MECC errors. This improves the 
reliability and testability of handling memory errors. 

D Special kernels were configured (from source) to simulate resource depletion. 
This helped uncover software errors which would not occur if resources were 
available. 



The processing of network protocols has now been placed under its own lock called 
the domain lock. This allows file system service to occur in parallel with protocol 
processing. 



The kernel can now perform softcalls in parallel. This is used for the processing of 
soft-clock ticks and for the initiation of protocol processing of incoming packets 
(netisr's). 



Parallel NFS and 
OVERLAPPED Writes 



The service of NFS requests has been made parallel up to the point of calling into 
the file-system layer. These changes provide faster NFS support by several mech- 
anisms: 

O overlapped buffer writes: NFS has a bottleneck when writing multiple blocks 
of the same file across the network. Although the write requests could be 
transmitted in parallel by the client-side biods, the server-side nfsds serialized 
the writes because of the requirement for each write to write to the buffer 
holding the file's inode as well as writing the actual data. In 4.1C this 
bottleneck is removed - a different locking mechanism is used for the inode 
buffer writes, permitting the data writes to occur in parallel. 

□ process synchronous writes: similarly, the prior implementations of NFS 
caused parallel write requests to the same file to become serialized because the 
inode itself was locked sequentially (as opposed to the memory buffer holding 
that inode). By changing the nfs daemons to use process synchronous writes, 
they are able to parallelize multiple writes to the same file (inode) arbitrarily, 
as long as all those writes are complete at the point the nfsd sends 
acknowledgment back to the client side. 

n event counters: new kernel primitives were added to 4.1 C to support waiting 
for certain values in a counter (permitting a greater degree of parallelism). 

O modifications to the buffer system: many changes were made to the buffer 
system implementation to support overlapped writes. 
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Support for Large (> 2 Gbytes) 
Physical Memory 



Parallel FDDI Driver 



OS/MP 4, IB supported a maximum of 2 Gbytes of physical memory in one system. 
This limit is extended to 4Gb in OS/MP 4.1C. 



The pg fddi driver has been parallelized. This allows the driver to receive and trans- 
mit packets while the system is doing file system operations. 



Boot and Install From Tape or 
CDROM Drive on First 

Boss™ Controller 



GENERIC and INSTALL kernels have been modified in OS/MP 4.1C so that the 
first SCSI bus on the first BoSS controller channel (sv2) supports two tape drives 
(st2 and st3) and a cdrom (srl). In order to boot and install from BoSS, you need 
only address your device(s) as specified here (4, 5, and 6 respectively), so that the 
kernel will recognize the devices. 
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Miscellaneous Software 
Information 



This section contains the following information: 

O Layered Products 

O Perfmon 

a Kernel Configuration 

O ROM features 

a Setting the bootROM environment 

O Unsupported software features 

O System architectures 

a SunView™ 



Layered Products 



Layered products running on OS/MP 4.1C may require revision upgrades. The fol- 
lowing table lists the layered product and the required revision level for operation 
with OS/MP 4.1C. Attempts to run previous revisions of these software products 
may produce unexpected results and is not supported. Please contact Solboume if 
you do not have the current versions of these products. 

Table 3. Layered Product Revision Requirements with OS .MP 4.1C 



Layered Product 


Revision Level 


SVM 


1.3 


hsNFS 


2.2 


DES 


4.1C 


X.25 


No change from OS/MP 4. IB 
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Perfmon 



Kernel Configuration 



Perfmon (Rev. 1.0.1) is required for OS/MP 4.1C This revision is based on patch 
number p93102501which is available from Technical Support. Please contact Sol- 
bourne Technical Support to obtain this patch. 

There is a workaround for users that wish to run Perfmon 1.0 on OS/MP 4.1C in 
the interim. The workaround is to execute the following commands as root: 



cd $PERFMONHOME/bin 



iiiiili: 



s collect_stats-4 






collect 



liiiiaiiiiiiii 



iiil 



This creates a symbolic link that allows Perfmon to recognize the collect_stats pro- 
cess on OS/MP 4.1 C. 



The type of kernel you can configure depends on the kernel architecture of the ma- 
chine, which may be determined using the arch -k command. 

To configure a Series S4000 kemel, change directory to/sys/idt/conf and use con- 
fig(8). The generic kemel configuration file is named GENERIC. Refer to the file 
/sys/idt/con^README for more information on customizing a kemel. 

To configure a Series5, Series5E, or Series6 kemel, change directory to/sys/kbus/- 
conf and use config(8). The generic kemel configuration file is named GENERIC. 
Refer to the file /sys/kbus/con^README for more information on customizing a 
kemel. 

The kemel configuration files from previous OS/MP releases are not compatible 
with the kernel configuration files for OS/MP 4. IC. Compare your previous kemel 
configuration file with the generic OS/MP 4. IC kernel configuration file and make 
the corresponding changes to the OS/MP kemel configuration file. 

The generic kemel does not provide configuration information for the Multi-Chan- 
nel Accelerator Board. Refer to the System and Network Administration manual 
and the Release Notes for the Multi-Channel Accelerator Board. 

The GENERIC config file does provide configuration information to support two 
VMEbus Cougar controllers (sv2 through sv5) and two BoSS enclosures. Refer to 
the BoSS Release Notes and Update Pages (part number 106181). 

One major change between the OS/MP 4. IB GENERIC config file and the OS/MP 
4.1C GENERIC config file is new 4.1C support for installing from BoSS. The 
OS/MP 4. IB GENERIC kemel has these lines: 



/^disk sd24 at sv2 drive 0x04 flags 0x4a 

disk sd25 at sv2 drive 0x05 flags 0x4a 

disk sd26 at sv2 drive 0x06 flags 0x4a 
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OS/MP 4.1C GENERIC config file comments out the previous lines and added 
these: 

^tape st2 at sv2 drive 0x04 flags 0x100 

tape st3 at sv2 drive 0x05 flags 0x100 

disk srl at sv2 drive 0x06 flags 0x100 

Notice that the OS/MP 4.1C GENERIC config file has added two tape devices 
(st2 and st3) and a CDROM device (srl). These additions make it possible to 
boot from Cougar controller channel sv2. Also note that these devices are using 
the addresses previously used by disks sd24, sd25, and sd26. 

Example Kernel Configuration 

The following is an example of how to change the kernel back to supporting sd2 4, 
sd2 5, and sd2 6 on Cougar controller channel s v2 . 

1 . Create a kernel configuration file to edit: 

j^# cd /sys/idt/conf 

# cp GENERIC BACKTODISKS 

# chmod U4-W B&CKTODISKS 

2. Edit the BACKTODISKS file. 

a. Go to the lines that contain : 

tape st2 at sv2 drive 0x04 flags 0x100 

tape st3 at sv2 drive 0x05 flags 0x100 
V ^ disk srl at sv2 drive 0x06 flags 0x100 ^ 

b. Comment out these three lines by inserting a # symbol at the beginning of 
each line. 

c. Go to the lines that contain: 

#disk sd24 at sv2 drive 0x04 flags 0x4a 

#disk sd25 at.sv2 drive 0x05 flags 0x4a 
^ #disk sd26 at sv2 drive 0x06 flags 0x4a 

d. Remove the # symbol at the beginning of each line. 

3. Run config: 

/^# usr/etc/config BACKTODISKS 
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4. Build the kernel: 



r# Cd - . /BACKTODISKS 

# make 

# ittv /vmuniac /vmunia:- orig 

# cp vmunix / 

# reboot 



ROM Features 



VME_RORA ROM Variable: 

A ROM variable called VME_RORA is available to inform the kernel that there 
is a VME Release on Register Access (RORA) interrupter on the VME bus. By set- 
ting this variable to 1, the OS will call the interrupt handlers routines immediately. 
By default, the OS will queue VME interrupt requests and process them later. This 
algorithm works fine with Release on AcKjiowledge (ROAK) VME boards, which 
is type the Solboume sells. If one sees a console message, WARNING : swi t ch- 
ing to RORA interrupt mode, then the OS has seen many unanswered 
interrupt requests and has automatically turned on the VME_RORA interrupt han- 
dling. Turning on VME_RORA will slow cumulative response times for busy 
VME systems. 

UNAME ROM Variable 

UNAME is a new ROM variable that allows a system administrator to toggle the 
command uname's output. By setting the UNAME to sun, uname will retum a 
sun compatible output like SunOS tests 4.1.3 3 sun4. Some SPARC soft- 
ware packages use uname during installation to figure out the system architecture. 
The following are examples of setting the UNAME ROM variable from the Unix 
prompt and the ROM prompt respectively: 



|j|||i:|||i||||^^^ 



• 



(R0M> setenv UNAME sun 



i 



Setting the BootROM 
Environment 



BootROM environment variables that describe devices have the syntax: 



( [protocol. ] device { [ctlr] , [unit], [devid] ) 
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Empty parentheses () or empty fields („) default to 0. protocol is required for 
SCSI devices and Ethernet devices. For SCSI, the legal protocols are sd and st. For 
Ethernet, the legal protocol is tftp. 

□ The disk unit number corresponds to the disk's SCSI address, devid describes 
partitions for disks (0 to 7 corresponding to partition a to h) 

□ Tape unit numbers are determined by adding 4 to the number in the /dev entry. 
In other words, the unit number for stO is 4, and stl is 5. The tape devid is the 
file on tape (the first file being number 0). 

□ Ethernet unit should always be 0. The devid is the IP host number of the system 
being contacted. On Series S4000 machines with an SBus*^^ Ethemet 
controller, the ctlr field should contain the slot number of the controller. The 
controller on the motherboard is represented by a value of 0. 

The bootROM environment variables listed in Table 4 must be set. The values 
shown in the table are correct for using sdO (with the I/O ASIC controller) as the 
boot disk and using a frame buffer. 

Table 4. BootROM Environment Variables 



Variables 


Value 


Meaning 


DEFAULTROOT 


sd.siO 
sd.sv(2,l) 


root filesystem disk and partition 
BoSS example 


DEFAULTSWAP 


sd.si(„l) 
sd.sv(2,3,6) 


swap disk and partition 
BoSS example 


DEFAULTDUMP 


sd.si(„l) 


kernel dump device 


DEFAULTBOOT 


vmunix 


kernel to boot 


DIAGBOOT 


sd.si(„6)kvm/st 
and/dg 


diagnostic to boot when in diag 
mode 


BOOTMODE 


manual/auto 


automatic reboot off 


INSTALLED 


Oorl 


1 = mandatory files already 
installed 


NOSPINNER 


Oorl 


1 = suppress "N pages left" in 
dumps, savecore 


INPUT-DEVICE 


keyboard, ttya, 
ttyb 


console input (Series S4000 only) 


OUTPUT-DEVICE 


screen, ttya, 
ttyb 


console output (Series S4000 
only) 


CONSOLE 


bw(), cgO, zs(), 
orfbO 


monitor type (Series 5, 5E, or 6 
only) 



For Series S4000, set INPUT-DEVICE and OUTPUT-DEVICE; for Series5, Se- 
ries5E, and Series6 set CONSOLE instead. 
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To print the bootROM environment, use the command: 

( ^ ROM>- printenv ) 

The command to set a bootROM environment variable is: 

Cr0M> aetenv vari abls value j 

There is a space (not an equal sign) between variable and value. 

For Series S4000, begin by setting the INPUT-DEVICE variable. For example: 



iliilillliillilii^ 



This sets the console input to the keyboard on a Series S4000. 

If OUTPUT-DEVICE is set to screen, the last frame buffer found in the system 
will be used as the output device. If frame buffers are installed in Sbus slot 1 and 
Sbus slot 3, the console output would be displayed on the frame buffer in Sbus slot 
3. Normally the Sbus slots are probed in numerical order (where slot 1 is the nearest 
to the power supply). This default probe order can be changed by setting the 
bootROM environment variable SBUS-PROBE-LIST. By setting SBUS- 
PROBE-LIST to 23 1, the console output would be displayed on the frame buffer 
in Sbus slot 1 . 

While the DEFAULTDUMP variable is normally set to a disk device, it can be set 
instead to a tape device, for example st.si(,4,). This is primarily intended for 
creating a tape to send to Solboume for investigating a crash. Customers wishing 
to examine this tape themselves can read the contents of the tape with the dd com- 
mand. An input block size of 8k must be specified, for example: 



|lllllii|liii|l^ 



After changing the bootROM environment, the bootROM must be reset to make 
the changes take effect: 



(ijii||llliilljj^^ 



Using reset warm forces reinitialization of the system. If reset cold is used, the 
Solboume system comes up just as it does from a power-up start. 
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Table 5 describes some examples of boot devices. 

Table 5. Examples of Boot Devices 



value 


partition/file 


description 


sd,si() 


a 


SCSI disk (sdO) 


sd.si(„6) 


g 


SCSI disk (sdO) 


sd.si(,l,) 


a 


SCSI disk 1 (sdl) 


xd(,3.) 


a 


IPI/SMD disks (xd3) 


st.si(,4,) 





SCSI tape (stO) 


st.si(,5,l) 


1 


SCSI tape 1 (stl) 


sd,sv(2,3,6) 


g 


SCSI disk 3 on BoSS 
(sv2) 


tftp.ei („34) /path/name 


/path/name 


from system with host 
number 34 on local 
subnet 


The usage format for SCSI disks is as follows: 


llllljljll^^ 


^^^^^^^^^^m 



For example, the command to set the DEFAULTROOT unit to SCSI disk 1 and the 
partition to a ("sdl a", in Unix terms) follows: 



(^ROM> satenv defaultroot ad. si (,1,0) 



For IPI and SMD disks, use the following command syntax: 



I 



(^ R§|l|iiiiili|||M 



The controller value should be if there is only a single controller. The default root 
and default swap must use controller and unit 0-3 to boot properly with generic 
kernels. 

A ROM environment variable has been added that allows the "slowing down" of 
the SCSI bus by limiting the maximum synchronous transfer rate that will be ne- 
gotiated. This may be useful with long SCSI bus cables or bus timeouts. The 5Mb/- 
sec transfer rate results in 200ns/byte. Setting the ROM environmental SI_N- 
SPERBYTE to 300 will slow down the transfer rate to a maximum transfer rate 
of 3.33Mb/sec. To slow the intemal SCSI bus type:. 



(^ROM> getenv 8i_n8perbyte 300 
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Similar problems on the Cougar controller can be addressed by setting the ROM 
environment variable: 



Unsupported Software 
Features 



System Architectures 



(^ROM> setenv SVii_MODE nsperxf er^x 



I 



See the sv(4) man page for more details. 



The following software and hardware features are not supported in OS/MP 4.1C. 
O Cgfour color frame buffers 

□ VME controllers which intermpt at VME priority level 7, 

□ DES encryption facilities are supported through a separately available release 
tape. 

• /usr/bin/crypt 

• /usr/bin/des 

O Loadable modules are not supported. 

□ Device drivers are not binary compatible with SunOS 4. 1 .2 or 4. 1 .3. 

□ There is no support for new hardware with extended VME addressing. 

□ "Special" drivers, including any and all device drivers from third-party 
vendors, may or may not work with OS/MP 4.1C. If "special" drivers are 
installed on your machine, contact the vendor(s) that supplied them. 

□ The following files are not included in OS/MP 4. 1 C: 

• /usr/etc/gpconfig 

• /usr/lib/*.ucode 



Solboume systems have an application architecture of "sun4". This is the output 
printed by arch(l). The kernel architecture is either "Series5", "Series6", or 
"S4000." These are the outputs printed by arch -k. The exit code for arch sun4 
is 0; for other argument values, the exit code is 1. 



SunView™ 



Version 1.8 of SunView is included with OS/MP 4.1C. This is the same version 
currently available from Sun. The SunView application dbxtool is not included. 
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CPU Boards 



Supported Hardware 



The OS/MP 4.1C release supports the hardware listed in this section. Solboume 
provides installation instructions with each supported peripheral. 

New hardware supported by OS/MP 4.1C include the Series6 50Mhz CPU and the 
2 Gbyte 3-1/2-inch SCSI Disk Drive. 



Software support for Solboume' s new Series6 50Mhz CPU board is introduced in 
OS/MP 4.1C. In addition to the Series6 50Mhz CPU, the software also supports 
Sbus products (S3000 and S4000) and the Kbus products (Series5, SeriesSE, and 
Series6 33Mhz CPUs). 

The Series6 33Mhz and 50Mhz CPU board may only be installed in Model 700 and 
Model 900 systems. 

* * * CAUTION * * * 

When using the romcopy command to upgrade bootROMs in Series6 CPUs, 
make sure the master CPU has the latest BootROM revision level of all CPUs 
in the system. If by accident a lower BootROM revision level is copied from an 
older CPU master, the system may not boot. 

Please refer to the Senes6 50Mhz CPU Board Release Notes (106532), the Se- 
nes6 Release Notes and Update Pages (part number 106145), and the man pag- 
es cpustatus{S), and romcopyiS) for more information. 
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Memory Boards 



The following memory boards are supported with OS/MP 4.1C. Notice that the 16 
Mbyte and 32 Mbyte memory boards are no longer sold by Solboume. 

Table 6, Memory Boards 



Memory 


Discontinued 


16 Mbyte Memory Board 


Yes 


32 Mbyte Memory Board 


Yes 


128 Mbyte Memory Board 


No 


256 Mbyte Memory Board 


No 


512 Mbyte Memory Board 


No 



OS/MP 4.1C supports more that 2Gbytes physical memory. Refer to the ' 'OS/MP 
4.1C Enhancements and Miscellaneous Software Information" section for details. 



Supported Disk Drives 



Software support for the 2 Gbyte 3-1/2-inch SCSI Disk Drive is introduced with 
OS/MP 4.1C. Table 7 hsts all the disk drives supported in the OS/MP 4.1C release. 

Table 7. Supported Disk Drives 



Device 


Bus 


Name 


830 Mbyte SMD Hard Disk Drive 


VMEbus 


xd 


1040 Mbyte SMD Hard Disk Drive 


VMEbns 


xd 


1 .2 Gbyte IPI Hard Disk Drive 


VMEbus 


xd 


2.7 Gbyte IPI Hard Disk Drive 


VMEbus 


xd 


327 Mbyte Hard Disk Drive (5-1/4-inch) 


SCSI 


sd 


661 Mbyte Hard Disk Drive (5-1/4-inch) 


SCSI 


sd 


2 Gbyte Hard Disk Drive (5-1/4-inch) 


SCSI 


sd 


1.3 Gbyte Hard Disk Drive (5-1/4-inch) 


SCSI 


sd 


1 Gbyte Hard Disk Drive (3-1/2-inch) 


SCSI 


sd 


2 Gbyte Hard Disk Drive (3-1/2-inch) 


SCSI 


sd 


500 Mbyte Hard Disk Drive (3-1/2-inch) 


SCSI 


sd 


200 Mbyte Hard Disk Drive (3-1/2-inch) 


SCSI 


sd 


1.44 Mbyte Floppy Disk Drive (3-1/2-inch) 


SCSI 


fdO 


CD ROM Drive 


SCSI 


sr 
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The LXT213 entry in /etc/format.dat is not supported by Solboume. The LXT200 
entry should be used instead. Solboume treats the LXT200 and LXT213 drives 
identically and formats both types to 200 Mbytes before shipping. Solboume may 
ship one type as a replacement for the other. 

The floppy disk drive is available only on Series S4000 machines. Other non-SCSI 
devices are not available on Series S4000 machines. 



Banks of SCSI Storage 

(Boss™) 



All hard disk drives are shipped with a default partition. 



Not only is BoSS supported in OS/MP 4.1C, but the enhancement to boot from 
BoSS has been added as well. GENERIC and INSTALL kemels have been modi- 
fied in OS/MP 4. IC so that the first SCSI bus on the first BoSS controller supports 
two tape drives (st2 and st3) and a cdrom (srl). See the OS/MP Enhancements sec- 
tion for more information. 



Drive Controllers 



Table 8 lists the SCSI Controllers supported in the OS/MP 4.1C release. 
Table 8. Supported SCSI Controllers 



Device 


Type 


Name 


System Board 


SCSI 


si 


Cougar SCSI-II controller 


SCSI-II 


sv 


Multi-Channel Accelerator Board (MCAB) 


SCSI (or with 
controller: 
SCSI-II, or IPI) 


sil 


IPI Controller 


IPI 


xdc 


SMD Controller 


SMD 


xdc 



The System Board only supports SCSI-1 type interface. The Multi-Channel Accel- 
erator Board (MCAB) supports both SCSI-1 and SCSI-II (SCSI-II is supported 
only if Cougar Board is installed in MCAB) type interfaces. The Cougar controller 
only supports the SCSI-II type interface. 

OS/MP 4.1C has been enhanced to support booting from sv2. sv2 is the first of 
eight SCSI-II channels in the kernel configuration file. See the OS/MP Enhance- 
ments section for details. 
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Tape Drives 



Table 9 lists the tape drives supported in the OS/MP 4,1C release. 

Table 9. Supported Tape Drives 



Tape Drive 


Bus 


Name 


QIC- 150 


SCSI 


St 


8mm Cartridge (8200/8500) 


SCSI 


St 



Tape drives are accessed via entries in /dev, all tape drives are on the SCSI bus. 
MAKEDEV creates mt devices by making hard links to the corresponding st de- 
vice; /dev/rstO is identical to /dev/rmtO and either name can be used to access the 
tape. For devices that support multiple densities, consult the st(4) manual page for 
information on how to manipulate the unit number to access the various densities. 
Tape operations are on the character (raw) device, such as /dev/rstO; /dev/stO is the 
block device. 



(n)r s t 



no rewind 



raw 



tape 



SCSI 



The dump and restore commands were modified prior to 4.1 C to use a media da- 
tabase, /etc/media. The M option causes dump and restore to consult the database 
to determine the blocking factor, length and density to maximize the tape use. Use 
the following command to dump file systems: 



:) 



r# dtmisp OMf media /dev/nrst8 fi 1 esys tern 



where medi a is the media type described below and fi 1 esys t em is the file sys- 
tem to dump. Use /dev/nrst9 if the tape drive is set to SCSI id 0x5 (stl). 

Table 10 gives a sampling of the different media types described in the /etc/media 
file. Additional media types may be added by editing /etc/media. Refer to the me- 
dia(5) man page for details of this database. 

Table 10. Examples of Media Types 



Media 


Format 


Description 


Q150_600 


QIC-150 


1/4-inch 600-foot XTD tape 


P6-120 


466033 


8mm cartridge tape 
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* * * NOTE * * * 

dump indicates it is rewinding the tape even when using a no-rewind name. Ignore 
the message. 

For example, the following command gives the maximum tape use for a QIC- 150 
with a 600 XTD tape: 

(jt dvaxxg OMf Q150_600 /der/nrstl /usr ^ 

The generic kernel supports two SCSI tape drives. To add a first or second tape 
drive, power down the system, plug in the drive and reboot. One drive must be set 
to SCSI id 0x4, while the other drive must be set to SCSI id 0x5 to be 
recognized. See the hardware installation manual for the device to determine how 
to set the drive to the appropriate SCSI ID. 

To add more tape drives, the kernel must be reconfigured. A maximum of eight 
tape drives may be configured. See the OS/MP 4.1 C Enhancements and Miscella- 
neous Software Information section for details. 

The following list gives specific information about the supported tape drives: 

QIC-150 The QIC- 150 drive has the capacity to store 1 50 Megabytes 

when using 3M^^ 600 XTD tapes. When reading tapes using the QIC-150 drive, 
the tape format (QIC-150, 120, 24, or 11) is automatically detected by the tape unit; 
therefore, tapes created with a QIC-24 drive can be read with the QIC-150 drive. 
The drive always writes QIC-150 format. 

8mm Cartridge This drive has the capacity to store 2 Gbytes on the 8200, and 
5 Gbytes on the 8500, when used with P6-120 8mm cartridge tapes. 



Floppy Disk Drives 



Series S4000 machines contain an optional 3.5-inch floppy drive. This drive sup- 
ports two different densities. The low density is 720K (formatted) and the high den- 
sity is 1 .44Mb (formatted). Diskettes may be interchanged with Sun SPARCstation 
systems. Solboume provides a utility, pcnfs, to read and write MS-DOS-compati- 
ble diskettes. 

Several OS/MP 4.1C commands work with the floppy drive. Please refer to the ap- 
propriate manual pages for details. 

□ fdformat(l) is used for formatting a diskette. By default fdformat assumes 
that a high density diskette is in the drive. If a low density diskette is being 
formatted, the -1 (for "low") option should be used. 

O eject(l) is used to remove the diskette from the drive. 

□ bar(l) can be used to dump a file or files to the diskette that normally would 
not fit. When bar completes writing to one diskette, the diskette will be ejected 
and a request for a second diskette will be made 
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The /dev entries for the floppy are shown in Table 1 1 : 

Table 11. Floppy /dev Entries 



Device 


Partition 


/dev/rfdOa 


partition A on the raw disk 


/dev/rfdOb 


partition B 


/dev/rfdOc 


partition C 


/dev/rfdO 


same as partition C 


/dev/fdOa 


partition A on the diskette using block mode 


/dev/fdOb 


partition B 


/dev/fdOc 


partition C 


/dev/fdO 


same as partition C using block mode 



Network Controllers 



Table 12 lists the Network controllers supported in the OS/MP 4.1C release. 
Table 12. Supported Network Controllers 



Device 


Name 


System Board Ethernet controller 


eiO 


Sbus Ethernet controller (Series S4000) 


eil 


Multi-Channel Accelerator Board (MCAB) Ethernet Controller 


eil 


VMEbus Ethernet controller 


egO 


VMEbus FDDI controller 


pgo 


VMEbus X.25 Controller (see X.25 Release Notes) 


vcO 



The System Board Ethernet controller is a standard component. The Sbus Ethernet 
controller (usable on the Series S4000) is available from third-party vendors. To 
add the Sbus Ethernet gateway, install the card in the system and make the indicat- 
ed changes to these files: 

nie add following 

/etc/hosts internet_addressgatewayname Hne containing 'localhost' 

/etc/hostname.eil gatewayname (create new file) 

or hostname.pgO 
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The I/O ASIC Ethernet controller is standard on Series 5, 5E, and 6 systems. To 
add the VMEbus Ethernet or FDDI gateway on one of these systems, install the 
controller in the system and make the indicated changes to these files: 

file add following 

/etc/hosts internet_address gatewayname line containing 'localhost' 

/etc/hostname.egO gatewayname (create new file) 

* • * NOTE * • * 

If your network uses Network Information Service (NIS^'^), the internal _address 
and gateway must be added to the maps on the NIS/YP master as well as the local 
/etc/hosts fde. 

gatewayname is the name for the Ethernet interface, often hostname_gw, it must 
be distinct from the name used for the onboard interface. The Sbus Ethernet con- 
troller is configured into the generic kemel. After you have made these changes, 
reboot the system. 



Serial Multiplexers 



The generic kemels for Kbus systems (Series5, SeriesSE, and Series6) support four 
serial mux controllers. Each serial mux controller supports 16 lines. Modify the 
MAXUSERS setting on the kemel depending on the number of serial mux control- 
lers in the system. To modify MAXUSERS, edit the appropriate kemel configura- 
tion file in /sys/kbus/conf and set MAXUSERS equal to the quantity 
((number_of_serial_mux_boards * 16 ) + 8). After you have modified 
the configuration file, configure and build a kemel. 
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Keyboards and Consoles 



Keyboards 



OS/MP 4.1C supports the international keyboard layouts provided in SunOS 4.1 .2, 
and supports two keyboard styles: a PC-style keyboard and an engineering-style 
keyboard. 

The international keyboards provided are installed by setting the ROM environ- 
ment variable KBD_LAYOUT to the appropriate hex value, x (shown in Table 
13). For example: 



IliMlillilllll^ 


llillil?lii!;iil!liliiiiii 


"^ 


Table 13. Country hex values 


Country 


Hex Value 


1 


US 


00 


1 


FRANCE.BELGIUM 


02 


CANADA.FRENCH 


03 


DENMARK 


04 


GERMANY 


05 


ITALY 


06 


NETHERLANDS 


07 


NORWAY 


08 


PORTUGAL 


09 


SPAIN_LATINAMERICA 


Oa 


SWEDEN_FINLAND 


Ob 


SWITZERLAND.FRENCH 


Oc 


SWITZERLAND_GERMAN 


Od 


UK 


Oe 


JAPAN 


20 



The PC-style keyboard is compatible with Sun's Type-4 keyboard. OS/MP 4.1C 
maps the PC-style keyboard so it is identical to Sun's Type-4 keyboard. Applica- 
tions that expect the Type-4 keyboard, such as editors, will recognize the PC-style 
keyboard as a Type-4. 

The Engineering-style keyboard is compatible with Sun's Type-3 keyboard. 
OS/MP 4.1C maps the Engineering-style keyboard so it is identical to Sun's Type- 
3 keyboard. Applications that expect the Type-3 keyboard, such as editors, will 
recognize the Engineering-style keyboard as a Type-3. 
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board/mouse is assigned to the device /dev/ttycl. The devices /dev/fbl, /dev/k- 
bdl, and /dev/mousel refer to this board. Additional color frame buffer boards 
would be assigned to /dev/ttyc2 or /dev/ttyc3. 

On Series5, SeriesSE, and Series6 systems, the I/O board contains a bwtwo mono- 
chrome frame buffer and keyboard interface. It is assigned to the next console de- 
vice, either /dev/ttycl, /dev/ttyc2, or/dev/ttyc3, depending upon how many color 
frame buffer devices exist. 

The screenblank(l) command now accepts a -u option for use when a serial port 
is used as the console, or when two graphics displays are in use. The argument to 
-u indicates the unit number (1-3) of the display to be blanked. 

With this configuration, Solboume supports running a windowing system, either 
SunView^^ or X. If started from a normal login running on /dev/ttycl, then the 
command suntools is all that is required, since the alternate kbd and mouse devices 
allow the kernel to reopen the correct kbdl and mousel devices. A console window 
can be invoked, and any output to /dev/ttycl will appear in this window. The/dev/- 
console always refers to the serial port. 



Multiple-Display Consoles 



If more than one frame buffer exists, the OS/MP adjacentscreens(l) utility is sup- 
ported. For instance, the following commands would start SunTools and extend 
the windowing system to the second frame buffer: 

'^# stmtoois 

> ^# stintools -d /dev/fb2 

To connect the displays, use the following command: 



Iplliilll^ 



I 



When using the X Window System, multiple displays are automatically connected 
by the X server. 



46 Supported Hardware 



Known Problems in OS/MP 4. 1 C 47 



Known Bugs with OS/MP 4.1C 



In previous releases of this document, the bugs were hsted by Category. 
The term Category is now referred to as Component. 



Bug# 


Component 


Sub-component 


B9 10508466 


Diagnostics 


ROM 


B910510198 


Diagnostics 


ROM 


B91 1218009 


Diagnostics 


POST 


B9208 14008 


Diagnostics 


DG 


B921 113002 


Diagnostics 


MDG 


B930629002 


Diagnostics 


Sysdiag 


B930914001 


Diagnostics 


Sysdiag 


B93 11 10001 


Diagnostics 


MDG 


B910508309 


Documentation 


Manual 


B910508428 


Documentation 


Kernel 


B910508455 


Documentation 


Man pages 


B910508457 


Documentation 


Man pages 


B910508458 


Documentation 


Man pages 


B9 105 10046 


Documentation 


Manual 


B910510068 


Documentation 


Man pages 


B910510188 


Documentation 


Manual 


B910510189 


Documentation 


Man pages 


B910619003 


Documentation 


Release Notes 


B920618002 


Documentation 


Manual 


B9207 10001 


Documentation 


Manual 


B920811001 


Documentation 


Manual 


B9208 17005 


Documentation 


Manual 


B921210002 


Documentation 


Man pages 


B92 12 10004 


Documentation 


Man pages 


B92 121 0005 


Documentation 


Man pages 


B92 1210006 


Documentation 


Man pages 


B92 1210007 


Documentation 


Man pages 


B930205001 


Documentation 


Release Notes 



Summary 

S4000 stand-alone clock driver doesn't return correct date/time. 

3.4 Series5 BootROMs don't deassert sysfail on warm starts. 

3.5 Series5 ECC RAM test in the POST does not enable ECC 
checking. 

Disk write/read test fails when prompted. 

Shared Memory Test fails. 

sysdiag fpu error report format 

vmem only tests 40 kilobytes. 

MDG will fail test 8 if master CPU is in slot 1. 

problem in SysAdmin Manual "Adding a modem" 

mt ret of Exabytes do not work. 

sd man page should describe SCSI disk cmd optimization. 

The eeprom man page shouldn't mention CONSOLE variable. 

The eeprom man page should describe defaultdump. 

page 4-7 of the adb tutorial has a 68020 assy, example. 

/usr/man/man3/List.* files missing 

QIC-150 tape drive. 

tunefs man page needs more info on -a option. 

boot of remote ramdisk may result in rarp timeout. 

device drivers man. incorrect about vme32 master to kbus 

transactions 

The burst data transfer rates are incorrect in the 500 Installation 

manual. 

documentation omission in System Admin Manual 

Installation guide for Interphase ethernet board has switch setting 

discrepancy. 

man page for config command needs to be updated to include Series6. 

config_server man page should include reference to Series6. 

install_client man page should be updated in reference to OS 

examples. 

boot man page missing 

kadb man page missing 

The BootROM level is missing from the Installation/Release notes. 
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Bug# 


Component 


Sub-coniponent 


B930205002 


Documentation 


Release Notes 


B9303 12002 


Documentation 


Release Notes 


B930322001 


Documentation 


Manual 


B930406005 


Documentation 


Man pages 


B9304 12002 


Documentation 


Other 


B9304 12004 


Documentation 


Man pages 


B930422002 


Documentation 


Man pages 


B930513001 


Documentation 


Release Notes 


B930525001 


Documentation 


Man pages 


B930903001 


Documentation 


Man pages 


B930920002 


Documentation 


Release Notes 


B930921002 


Documentation 


Release Notes 


B930928003 


Documentation 


Manual 


B93 1020001 


Documentation 


Man pages 


B93 1029001 


Documentation 


Man pages 


B921207001 


OS 


File system 


B93 1029004 


OS 


File system 


B931214001 


OS 


File systeni 


B910508404 


OS 


Kernel 


B910510235 


OS 


Kernel 


B91 1106002 


OS 


Kernel 


B920925003 


OS 


Kernel 


B92 1022003 


OS 


Kernel 


B921 119002 


OS 


Kernel 


B921 130001 


OS 


Kernel 


B921211002 


OS 


Kernel 


B921214002 


OS 


Kernel 


B930616001 


OS 


Kernel 


B930722001 


OS 


Kernel 


B930728001 


OS 


Kernel 


B931013001 


OS 


Kernel 


B931014001 


OS 


Kernel 


B93 1014002 


OS 


Kernel 


B93 1027001 


OS 


Kernel 


B93 1029003 


OS 


Kernel 


B931111002 


OS 


Kernel 


B931111004 


OS 


Kernel 


B93 11 16001 


OS 


Kernel 


B931 117002 


OS 


Kernel 


B93 1129002 


OS 


Kernel 


B93 1202001 


OS 


Kernel 


B93 1202002 


OS 


Kernel 


B93 1208001 


OS 


Kernel 


B93 1208003 


OS 


Kernel 



Summary 

Installation and release notes are missing remote install for Sbus 

machines. 

need remote installation instructions in the stand-alone section 

No software config info for FDDi in docs fpr 900/700/FDDI 

No cust. info, concerning how to utilize Hi Den mode on EXA-8500 

Enhancement to System I/O board notes 

eistat man page has strange comment 

man page says telnetd limits ptys to 64 

SVM release notes incomplete 

Ipadkeys -e conflicts with Solbpume usage in /etc/rc, single 

confjg_server man page does not list all options 

Instructions for dataless install incomplete 

remote CDROM installation instructions are not in OS/MP 4. IB 

Release Notes 

Power Components PSU should be added to the 900 Service Manual. 

spray(8) usage incorrect 

Man page on vi isn't clear on encryption requirements for the -x and 

-C options, 

df of device shows out-of-date information 

format,dat entry for Seagate STl 1200N 1.2Gb 3 1/2" drive wrong 

unable to mount NFS disks 

The label of an IPI disk may be overwritten by a swap om C partition 

Problem with incoming and outgoing modem on same port. 

s4000 maxusers greater than 24 will cause system to reset due to 

double trap 

eiO eiread mbuf allocation failure on low end SeriesS 

low-memory system starves processes 

Data fault panic running mmt test on SeriesS 

keyboard state not being set properly for keyboard resend 

io_tests hangs up on multi-cpu system 

Mux failures may occur on a BoSS system 

many lofs/tfs mount/unmounts can cause panic fbread 

cannot make a 4. IB kernel with LWP's commented out. 

cannot comment out Sunview support. 

Seeing bad signal stack messages on console 

lock time-out panic in swapout 

panic assertion failed m->m_type == MT_FREE 

data fault panic exiting Wingz in sunview 

Cougar driver complaining of double interrupt 

ps only prints u.u^comm with cores from >2GB machines 

SECC memory error early in boot causes panic... 

RUNLOCK panic 

Data fault panic 

unable to consistently sync file systems after kernel panic 

memory address alignment panic in login when STRMSGSZ==8k 

problems interrupting write to char special file in posix 

BAD TRAP, kernel read fault, data fault 

panic assertion failed cr != NULL, file ,./../os/kem_prot.c, line 708 
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Bug# 


Component 


Sub-component 


B93 1216004 


OS 


Kernel 


B93 1217002 


OS 


Kernel 


B93 1227001 


OS 


Kernel 


B93 1227002 


OS 


Kernel 


B93 1227005 


OS 


Kernel 


B940105001 


OS 


Kernel 


B9 108 13002 


OS 


Network 


B9 11204018 


OS 


Network 


B920403007 


OS 


Network 


B930329003 


OS 


Network 


B930614001 


OS 


Network 


B9 10912008 


OS 


Other 


B930630001 


OS 


Other 


B93 1013002 


OS 


Other 


B910508493 


OS 


System call 


B9205 13004 


OS 


User 


B920630005 


OS 


User 


B921028001 


OS 


User 


B921217004 


OS 


User 


B93 11 19002 


OS 


User 


B9401 10001 


OS 


User 


B9 105 10040 


Sunbug 


C 


B91 11 11004 


Sunbug 


C 


B911001002 


Sunbug 


File system 


B9207 10002 


Sunbug 


File system 


B9 10508295 


Sunbug 


Kernel 


B920131004 


Sunbug 


Kernel 


B930106001 


Sunbug 


Kernel 


B930301003 


Sunbug 


Kernel 


B930928004 


Sunbug 


Kernel 


B930929005 


Sunbug 


Kernel 


B910910001 


Sunbug 


Network 


B920414002 


Sunbug 


Network 


B910508283 


Sunbug 


Other 


B91 1204007 


Sunbug 


Other 


B921013005 


Other 


Sunbug 


B9308 18001 


Sunbug 


Other 


B930930002 


Sunbug 


Other 


B9203 18002 


Sunbug 


User 


B930624003 


Sunbug 


User 


B930716001 


Sunbug 


User 


B910508311 


Utility 


Editor 


B93 1029002 


Utility 


Editor 



Summary 

panic caused by NFS mounted disk access 

system hang with prg_rc_drain_resp in trace back 

vm_context lock time-out panic syncing disks 

prg_rc_drain_resp unknown response panic 

system hangs when trying to spawn large (1 136)of procs 

"memory board slot unknown" on SECC/MECC memory errors 

NFS default time-out is not 7/lOth sec. according to man page 

Pipe writes block differently than under SunOS 4.1. [12] 

spray statistics go negative for extreme traffic 

ifconfig's 'metric' option does not work 

egO interface dies with VMEbus error(20) on Oracle Benchmark 

partition does not see changes to label until reboot 

System header files not ANSI C, C+-f- compliant 

update running @ 30 sec. interval too heavy for tpca 

Commands can dump core when out of swap space 

eeprom -p option not always recognized 

no man page for the /usr/etc/scsistat man page 

mounting some CDROM is incompatible with Sun 

verilog jobs cause panic on large mem. config. (maxuser related?) 

/usr/etc/config dumps core on bad config file 

App. which works under 4.1 A.2 drops core under 4. IB 

Cpp mis-identifies itself 

ace fails if fflush(3) is used and program is statically linked 

You can write to a CDROM, creating a bad inode 

Ejecting CD while HSFS disc mounted may cause "segmap_release ' 

addr" panic 

aioread doesn't return EINVAL when it should 

cannot build valid kernel for diskless client 

rebooting causes /dev/console to change mode, group 

window displaylmutex lock broken messages 

too many open files in perennial test suite 

memory leak in rpc.lockd 

NFS timeoouts at double the timeo value for nfs read operations 

named complains about bad xfer when set up as a secondary 

nameserver 

12/1 tape no man page for Uutry 

4.1 man pages from Sun came with older dates than 4,0 man pages 

4. 1 A.3man pages for pstat do not explain the fields displayed with -u 

option. 

Need to know differences and enhancements from libc.so.1.7 to 

libc.so.1.8 

load with undefined symbol makes file with exec permissions 

bug in make 

Need the equivalent patch for sun bug 100972-01 

Script that works under bourne shell fails when run from "at" or 

"cron" 

need statically-linked editor on root partition 

vi options inconsistant with man pages, ex. -C 
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Bug# 


Component 


Sub-component 


B9 10508429 


Utility 


Installation 


B910510208 


Utility 


Installation 


B9207 14010 


Utility 


Installation 


B920825009 


Utility 


Installation 


B93 1123002 


Utility 


Installation 


B910927006 


Utility 


Integration 


B910510158 


Utility 


Library 


B910702012 


Utility 


Make 


B93 1103002 


Utility 


Make 


B910510016 


Utility 


Other 


B910510224 


Utility 


Other 


B930604001 


Utility 


Other 


B930805002 


Utility 


Other 


B930830002 


Utility 


Other 


B930920003 


Utility 


Other 


B93 1025001 


Utility 


Other 


B93 1026001 


Utility 


Other 


B93 1028002 


Utility 


Other 


B9311 15001 


Utility 


Other 


B931215001 


Utility 


Other 


B910510184 


Utility 


Sendmail 


B911 105001 


Utility 


Source control 



Summary 

dopackage does not update it list of variables after abort 

install enhancement for handling patches 

partition tool doesn't do anything with new mount points 

More templates are listed than can fit in the given space 

reinst_sys dies on SVM /etc/fstab 

stcmp doesn't understand binary RCS files 

getnetbyaddr(3N) doesn't take netmasks into account 

pmake leaves scratch files in current directory when .KEEP_STATE 

used 

pmake -c doesn't honor @ in Makefiles 

Dis(l)'s usage message refers to itself as *'kdis 

tip doesn't like being bung op on 

request 100344-01 

solpatch has hard coded paths under /var, cannot install patches on 

some machines 

solpatch list screen options mis-indented 

solpatch and it's supporting binaries are dynamically linked 

Australia Daylight savings time is off by a week. 

solpatch doesn't echo user input 

The audit flags under C2security work incorrectly. 

solpatch when opened in a wind larger than 132x100 then shrunk to 

132x75 give segmentation fault when -i opt used 

processes started on remote system with rsh never exit 

sendmail -bi incorrectly sets YP_MASTER_NAME 

Checking out file that's not under RCS renames original 
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OS/MP Bugs Fixed in OS/MP 4.1C 



In previous releases of this document, the bugs were listed by Category. The title Categroy is now referred to as 
Component. 



Solbourne OS/MP 4.1B bugs fixed in OS/MP 4.1C 

Bug# Component Subcomponent Problem Summary 

B930412003 Compilers Other request for sun patch 100606-03 

B9302 12001 Diagnostics DG dg doesn't understand multiple channel boards 

B920526004 Diagnostics Other Adding more than 256M on SeriesS boards causes misalignment panics. 

B9 10504221 Documentation Man_pages Xwd manual page needs info about swm windows 

B921210008 Documentation Man_pages monitor man page is really the bootrom man page 

B910510220 Documentation Release_Notes Keyboard explanation in release notes is misleading. 

B91 1017014 Documentation Release_Notes incorrect documentation on TCP/IP configuration 

B9 10508396 OS File_system You can truncate a newly-created read-only file on a NFS file system. 

B910510153 OS File_system NFS doesn't always check for "x" permission on directories. 

B910510160 OS File_system Sun NFS bug cause failure of SI test. 

B910510172 OS File_system 4.0D upgrade changes /etc/passwd file permissions to -rw-rw-rw (666). 

B920921003 OS File_system fsck doesn't find all dirty filesy stems on first pass. 

B93 1209002 OS File_system X.25 modifications necessary 

B910508320 OS Kernel "-target sun4" should be set in GENERIC confs makeoptions 

B910508334 OS Kernel Disk driver recovery doesn't release locks when system panics. 

B910508365 OS Kernel xd locking can break on busy systems. 

B9 10508394 OS Kernel pmake problem 

B9 10508442 OS Kernel Sparc Int'l test fails when cgfast installed. 

B910510135 OS Kernel st messages ignore shelltool console window. 

B9 10520001 OS Kernel Memory address alignment panics 

B9 107 16004 OS Kernel swap_xlate panic occurred 

B9 11017031 OS Kernel would like to add IPI drives dynamically 

B9 1 1 101004 OS Kernel many useless vmunix keyboard errors at 4. 1 .A. 1 

B920130012 OS Kernel divide by zero test program yields unpredictable results; 

B920814001 OS Kernel some processes starve in 4. IB 

B920814014 OS Kernel panic: should we really just allocate 12 pt here? 

B920825006 OS Kernel fsck hangs system with > 5 CPUs installed 

B920910005 OS Kernel ps prints negative numbers for %MEM and RSS with 1GByte memory. 

B92091 1001 OS Kernel usr.lib Makefile doesn't install Ubrpcsvc subdir. 

B920914006 OS Kernel CDROM on BoSS hangs SCSI bus 

B9209 14009 OS Kernel message requested when kmap_alloc falls below kmap_lowat 
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Bug# 


Component 


Subcomponent 


B920915002 


OS 


Kernel 


B920925002 


OS 


Kernel 


B920928003 


OS 


Kernel 


B921008001 


OS 


Kernel 


B92 1102001 


OS 


Kernel 


B921 112001 


OS 


Kernel 


B921 119001 


OS 


Kernel 


B921 119003 


OS 


Kernel 


B921204001 


OS 


Kernel 


B921211001 


OS 


Kernel 


B921217005 


OS 


Kernel 


B921218001 


OS 


Kernel 


B92 121 8002 


OS 


Kernel 


B921223001 


OS 


Kernel 


B930106002 


OS 


Kernel 


B930107002 


OS 


Kernel 


B930 113002 


OS 


Kernel 


B930126001 


OS 


Kernel 


B930 126002 


OS 


Kernel 


B930202001 


OS 


Kernel 


B930202005 


OS 


Kernel 


B930204002 


OS 


Kernel 


B930204003 


OS 


Kernel 


B930223001 


OS 


Kernel 


B930224005 


OS 


Kernel 


B930301001 


OS 


Kernel 


B930301005 


OS 


Kernel 


B930301006 


OS 


Kernel 


B930303003 


OS 


Kernel 


B930309001 


OS 


Kernel 


B9303 10001 


OS 


Kernel 


B9303 10002 


OS 


Kernel 


B9303 10005 


OS 


Kernel 


B9303 10006 


OS 


Kernel 


B9303 18002 


OS 


Kernel 


B9303 18004 


OS 


Kernel 


B9303 18006 


OS 


Kernel 


B9303 18007 


OS 


Kernel 


B930330003 


OS 


Kernel 


B930331001 


OS 


Kernel 


B930402002 


OS 


Kernel 


B930407002 


OS 


Kernel 


B930408002 


OS 


Kernel 


B930408003 


OS 


Kernel 


B930412001 


OS 


Kernel 



B9304 13002 OS 



Kernel 



Problem Summary 

swap space leak 

Random processes dump core under high user load. 

BAD TRAP: asyncio; Memory address alignment 

Using a volume as a block device in svm causes panic; 

Cannot configure eil in system with 6 CPUs & 1 MCAB 

ttycommon_qfull called wrong in Idterm flow control cases 

A Spurious interrupt can lower interrupt level. 

att panics on Series6 with lock_style set to debug 

remove support for cg40 

sysdiag panics system 

mount system call has bad check for uap->type 

multiple lock error panics 

lock timeout panics anon_decref 

cannot access 128Megs of the MCABs VME32 user space 

sr driver returns incorrect information from CDROMSUBCHNL ioctl 

Indirect system call with fork causes lock error panic 

async_memory_err can cause a deadlock situation 

choose_process could fail to find runnable processes 

swap_order causes anon_decref panic 

vme_rora doesn't work in 4. IB 

Gather TLB info in nmi routine 

pageval returned by vmepfnum is incorrect 

mapin kernel call does not support old PG_ flags 

system with 2.304GB of physical memory panics 

/dev/tcp has wrong minor number 

pagefault/system hang on kernel address 

lock violation: zs lock can't be taken after lock process 

eiO interface will hang with Series6 and OS/MP 4. IB 

Duplicate PIDs 

defaultdump not working at OS/MP 4. IB 

lock violation: lock semaphores after lock vm_context 

Bad printf is the memory address alignment trap. 

update holds the vm_context lock too long causing problems. 

Performing three read/write pairs on a socket take much longer than two 

read/ write pairs. 

choose process panics 

equivalent to Sun patch 100636-01 

lock timeout 

equivalent to Sun patch 100173-10 

poll on socket causes system to panic 

request for Sun Patch 100513-01 Jumbo tty patch 

lock timeout panics 

need support for >64 file descriptors 

Memory address alignment panic 

system hangs (choose_process) 

Oracle 7.0 cannot be installed from CDROM Solbourne/SUN HSFS driver 

doesn't support RockRidge Extensions 

add support for 8500C and 8505 Exabyte drives 
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Bug# 


Component 


Subcomponent 


B930414001 


OS 


Kernel 


B930416001 


OS 


Kernel 


B930416003 


OS 


Kernel 


B930423001 


OS 


Kernel 


B930426001 


OS 


Kernel 


B930505003 


OS 


Kernel 


B930511001 


OS 


Kernel 


B930512001 


OS 


Kernel 


B9305 12002 


OS 


Kernel 


B930512003 


OS 


Kernel 


B930521001 


OS 


Kernel 


B930525002 


OS 


Kernel 


B930526001 


OS 


Kernel 


B930526002 


OS 


Kernel 


B930528001 


OS 


Kernel 


B930608001 


OS 


Kernel 


B930622001 


OS 


Kernel 


B930630002 


OS 


Kernel 


B930706001 


OS 


Kernel 


B930708001 


OS 


Kernel 


B930708002 


OS 


Kernel 


B930712002 


OS 


Kernel 


B9307 13001 


OS 


Kernel 


B930713002 


OS 


Kernel 


B930713003 


OS 


Kernel 


B930713004 


OS 


Kernel 


B930713005 


OS 


Kernel 


B930713006 


OS 


Kernel 


B930713007 


OS 


Kernel 


B9307 14001 


OS 


Kernel 


B930806001 


OS 


Kernel 


B930813003 


OS 


Kernel 


B930817002 


OS 


Kernel 


B930824001 


OS 


Kernel 


B930825001 


OS 


Kernel 


B930831001 


OS 


Kernel 


B930831002 


OS 


Kernel 


B930901002 


OS 


Kernel 


B930914002 


OS 


Kernel 


B930924001 


OS 


Kernel 


B930928001 


OS 


Kernel 


B930928002 


OS 


Kernel 


B930929001 


OS 


Kernel 


B93 0929002 


OS 


Kernel 


B930929003 


OS 


Kernel 


B930929004 


OS 


Kernel 


B930930001 


OS 


Kernel 


B93 1005001 


OS 


Kernel 



Problem Summary 

eiclfree2 panic 

sd_unit panic for major device 24 

conf.o is being supplied in OBJ directory and shouldn't 

Member of group can remove file in dir where group has rwx even if unowned. 

Series6 system panics with a Fatal Asynchronous Fault 

The select system call may hang. 

ialloc: dup alloc panic 

lock timeout 

processes go into "D" state waiting for memory 

panic getting user pte from interrupt 

The utsname structure returns incompatible results. 

100347-03 

Bug in fcntl can cause lock error panic 

block_n_lock broken in the 1 cpu case 

request for sun patch 100666-02 

fddi hangs 

Interrupting aim 3 benchmark causes system to drop to single user 

Data fault panic 

hat_add_mapping returns garbage 

pstat is hardcoded to look at 10000 nfiles. 

Assertion failure. DEBUG kernels only, from soreceive() or sosendQ 

unable to install Ingres on sbus systems. Core dumps. 

wait_command_done panic in aim3 benchmark 

page_get map panic in aim3 benchmark 

page_hashout panic in aim3 benchmark 

out of memory panic in perennial test 

cannot start rfs on OS/MP 4. IB 

vm_context lock timeout panic in uucp_test 

bad trap/data fault in system_test 

vm_context lock timeout panic with aim3 and 256M memory 

tmpfs needs vm_context lock 

lock timeout panic 

race in krpc (ckuwakeup). timeout may need to know more about locks. 

kernel memory allocation causes crossed locks 

request for sun patch 100075-1 1 

dmesg reports negative memory for large-mem systems 

vmstat reports negative memory for large-mem systems 

panic in exit 

memory leak/corruption in ufs_getsummaryinfo 

adjtimeO loses at 4.1 C 

Data fault panics 

uiomove optimization does not occur unless LOCK_STYLE is debug 

mb_mapfree messages while probing SCSI devices 

perennial setrlimit test hangs on IDT 

IDT- specific problems in perennial test suite 

IDT time kernel stats zero in 4. IC 

illegal instruction panics from crashme test 

lock timeout panic 
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Bug# 


Component 


Subcomponent 


B93 1007002 


OS 


Kernel 


B93 1013007 


OS 


Kernel 


B931013009 


OS 


Kernel 


B931013011 


OS 


Kernel 


B931013013 


OS 


Kernel 


B93 1020002 


OS 


Kernel 


B93 1028001 


OS 


Kernel 


B93 1028003 


OS 


Kernel 


B931 101001 


OS 


Kernel 


B931 101003 


OS 


Kernel 


B93 1103003 


OS 


Kernel 


B93 1103004 


OS 


Kernel 


B93 1104001 


OS 


Kernel 


B93 1104002 


OS 


Kernel 


B93 1104003 


OS 


Kernel 


B93 1109001 


OS 


Kernel 


B93 11 10004 


OS 


Kernel 


B931111003 


OS 


Kernel 


B93 11 12003 


OS 


Kernel 


B931 112004 


OS 


Kernel 


B931 116003 


OS 


Kernel 


B931 119001 


OS 


Kernel 


B93 1123003 


OS 


Kernel 


B931201001 


OS 


Kernel 


B93 1202003 


OS 


Kernel 


B93 1207001 


OS 


Kernel 


B93 1209001 


OS 


Kernel 


B93 1216002 


OS 


Kernel 


B931216003 


OS 


Kernel 


B931221001 


OS 


Kernel 


B93 1222004 


OS 


Kernel 


B93 1223001 


OS 


Kernel 


B940107001 


OS 


Kernel 


B910510164 


OS 


Network 


B910510215 


OS 


Network 


B93 1013005 


OS 


Network 


B931013006 


OS 


Network 


B931111001 


OS 


Network 


B931 112005 


OS 


Network 


B93 1129003 


OS 


Network 


B93 1205001 


OS 


Network 


B931216001 


OS 


Network 


B910508287 


OS 


Other 


B910508306 


OS 


Other 


B910508342 


OS 


Other 


B910508427 


OS 


Other 


B910510111 


OS 


Other 


B910510132 


OS 


Other 



Problem Summary 

can't have DEFAULTDUMP on high-numbered BoSS disks 

Optimization in scsi.c can cause SCSI bus resets (OS/MP 4. IC only) 

code to support tags can prevent dumps on panic 

lock order violations when draining mbufs 

SunOS failed MCLGET and mclget leave different m_len values. 

Diskless clients can't panic correctly. 

NFS clients hang under heavy load. 

data fault panic in tcp_fasttimo routine 

processes get stuck using "oncpu" 

oncpu command showing bad values for previous PAM? 

several problems with >2G memory 

"cpu n not responding'* during reboot of >2G system 

CPUs go idle on >2G memory system 

vmstat "fre" value suspiciously large on >2G system 

performance penalty on >2G memory system 

data fault panics running SVM in 4.1C 

panic assertion failed: (bp->b_flags & B_WBUSY) II !(bp->b_flags & B_D 

Inv. Supervisor data load panic 

svm needs new kernel .o files for 4.1C. 

WAIU^IING: CPU in slot # not responding on reboot 

svfatal(DMA VMEbusTimeout(2l)) failure... 

Ingres shutdown causes Memory address alignment panic. 

Double Traps... 

mouse can't reach second screen in dual-headed sunview 

Store buffer faults caused by ECCM do not show any HW information. 

pg error panic 

FDDI hangs (deaf receiver) 

double drop of arp lock when no mbufs 

sa device driver with ASSERT kernels can panic. 

Drvconfig causes system to hang. 

space_reserve broken for VME space on Series6 

DES server panics on client mount requests 

System hang (running pmake on si drive + kbus_mon) 

running etherd or nfswatch causes data corruption. 

request for uuqueue and uusnap command 

OSMP 4.1C FDDI driver can leak mbufs. 

Calls to m_free with interface lock can lead order violations. 

nfsd daemons get stuck 

NFS mounts time out right away. 

possible panic when setting promise with FDDI (41Conly) 

pgstat -s corrupts driver pgstat statistics 

MGET_NOLOCK: possible expand with lock ff343860:'pg_0' 

References to Sun in admin files needs to be changed to Solbourne. 

Error recovery in drivers can induce lock timeouts. 

Network performance on kbus machines is bad. 

Adding an MCAB to the kernel config file is difficult. 

Plot files are missing from /usr/bin in 4.0C. 

The suntool disk performance tool doesn't work properly. 
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Bug# 


Component 


Subcomponent 


B9 105 10227 


OS 


Other 


B9 105 10239 


OS 


Other 


B911017013 


OS 


Other 


B9209 10006 


OS 


Other 


B921 106001 


OS 


Other 


B921217002 


OS 


Other 


B9301 13001 


OS 


Other 


B930204001 


OS 


Other 


B930225001 


OS 


Other 


B930519001 


OS 


Other 


B930608003 


OS 


Other 


B930920001 


OS 


Other 


B931013003 


OS 


Other 


B910510073 


OS 


Shell 


B9 10508494 


OS 


System_call 


B9 105 10077 


OS 


System_call 


B9208 12002 


OS 


System_call 


B930309002 


OS 


System_call 


B9 10508439 


OS 


User 


B9 105 10078 


OS 


User 


B921210003 


OS 


User 


B921216001 


OS 


User 


B921217003 


OS 


User 


B930202002 


OS 


User 


B930202003 


OS 


User 


B930202004 


OS 


User 


B910510137 


Sunbug 


C 


B910510030 


Sunbug 


Fortran 


B9 10510031 


Sunbug 


Fortran 


B9 105 10063 


Sunbug 


Fortran 


B910510085 


Sunbug 


Fortran 


B910723016 


Sunbug 


Fortran 


B9 105 10079 


Sunbug 


Kernel 


B920929003 


Sunbug 


Kernel 


B930402003 


Sunbug 


Kernel 


B9 10508450 


Sunbug 


Network 


B910510053 


Sunbug 


Network 


B9 105 10080 


Sunbug 


Network 


B910510098 


Sunbug 


Network 


B910510099 


Sunbug 


Network 


B910510144 


Sunbug 


Network 


B910513004 


Sunbug 


Network 


B930323002 


Sunbug 


Network 


B9 10508308 


Sunbug 


Other 


B9 105 10097 


Sunbug 


Other 


B910516001 


Sunbug 


Other 


B9 105 16004 


Sunbug 


Other 



Problem Summary 

NCD xterminal performance through mux card is slow. 

timed loses approximately 9 minutes a week. 

cannot close net. interface with ifconfig 

/etc/rc incorrectly tries to delete /dev/printer 

mpstat seems to report cpuO data in the average column 

autocad on sga20 occasionally draws bad vectors. 

Only 256 PTY's are in the /etc/ttytab file in OS/MP 4. IB; needs to be 736 as 

supported 

XI . 1 doesn't work with OS/MP 4. IB. 

cpustatus cannot disable cpu 0. 

request for sun patch 100174-06 

kvm_read sometimes lies 

Unable to load OS from remote CD-ROM using reinst_sys. 

device xvO in some Series6 config files 

/bin/sh dumps core - intermittently 

Series4 vfork(2) is really fork(2) 

EINTR erro 

bsf option of mt command returns i/o error. 

socketpair returns wrong errno 

bootparams entry is not deleted when installing client fails. 

Id error with very large libraries 

machid(l) command does not exist but man page does 

'sendmail' gets segv/buserr during AIM Utilities test 

panic if maxuser too large on large memory configuration 

Need patch for Sun patch 100408-01. 

Need patch for Sun patch 100399-02. 

Need patch for Sun patch 100413-01. 

Id and Id.so bugs in Sun's 4.0.3 

Fortran compiler goes into an infinite loop. 

exp involving fields of structures hangs the converter. 

Converter goes into an infinite loop. 

BOX and Z constants used only in DATA statements 

assembler grows to enormous size and pushes the load avg. high. 

data fault panics 

Simulated [su]div instructions are broken. 

system hangs 

Sun NFS bug causes failure of SI test. 

Directory scan permissions don't work on nfs mounts. 

pty fix 

NFS clients may hang under certain conditions. 

File corruption inode or vnode pointing to wrong file. 

NFS Jumbo Patch 

security bug: processes do not disassociate from ptys when user logs out 

We need sun patch # 100684-02 (RFS patch) 

12/18: Should /etc/motd be world writable? 

selection_svc and rpc can be used to gain access to system files 

various symbolic links in /usr/bin to sun view/... 

suntools files in /usr/lib 
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Bug# 


Component 


Subcomponent 


B920601002 


Sunbug 


Other 


B930107001 


Sunbug 


Other 


B9308 17001 


Sunbug 


Other 


B93 1124002 


Sunbug 


Other 


B9 105 10230 


Sunbug 


System_call 


B910510041 


Sunbug 


User 


B910510042 


Sunbug 


User 


B9 105 10062 


Sunbug 


User 


B910510181 


Sunbug 


User 


B920708004 


Sunbug 


User 


B930 119002 


Sunbug 


User 


B930 120001 


Sunbug 


User 


B930305005 


Sunbug 


User 


B930413001 


Sunbug 


User 


B910508399 


Sunbug 


system 


B930204004 


Sunbug 


system 


B920716001 


Utility 


Client_server 


B9209 10002 


Utility 


Client_server 


B930329004 


Utility 


Client_server 


B910508293 


Utility 


Installation 


B910508345 


Utility 


Installation 


B910508346 


Utility 


Installation 


B910508452 


Utility 


Installation 


B910508453 


Utility 


Installation 


B910517002 


Utility 


Installation 


B910614003 


Utility 


Installation 


B920716004 


Utility 


Installation 


B92 1103005 


Utility 


Installation 


B921 105001 


Utility 


Installation 


B92 1106002 


Utility 


Installation 


B930830004 


Utility 


Installation 


B931001001 


Utility 


Installation 


B931022001 


Utility 


Installation 


B931116002 


Utility 


Installation 


B910510157 


Utility 


Library 


B921019002 


Utility 


Library 


B93 1021001 


Utility 


Mail 


B910508322 


Utility 


Other 


B910508362 


Utility 


Other 


B910508373 


Utility 


Other 


B9 10508420 


Utility 


Other 


B910510109 


Utility 


Other 


B910510205 


Utility 


Other 


B910703001 


Utility 


Other 


B91 1101001 


Utility 


Other 



Problem Summary 

3rd Party software which uses 'delay' function will not work. 

The /usr/include/utmp.h file is wrong when there are more than 64 pty's 

Need equivalent to Sun patch 100972-01 " at jobs not running: files being 

overwritten" 

request for sun patch 100407-07 

4.0D poll returns POLLHUP when console is used. 

cron queudefs file is ignored 

Jobs must ALL complete before newly added jobs will run. 

make does not expand all dynamic macros properly when additonal suffixes 

are declared without rules. 

mount command prints bogus WARNING unknown options quota message 

request that tip does ioctl call to save window settings 

need OS/MP 4. IB patch for Sun patch 100399-02 

need to generate Sun patch 100413-01 

ipcs aborts with "shcmtl: permission denied" 

equivalent to Sun patch 100383-06 

Attempting to mount swap space hangs machine. 

Should run CERT file permission script to check and possibly fix file 

permissions 

Cannot install a Solbourne client from CDROM. 

config_server - it is desirable not to have /etc/exports modified; 

config_server uses rstO instead of nrstO 

12/18: error installing X when man pages don't exist 

config_server ungraceful about perm denied 

config_server tape usage inefficient 

soft links are not created during installation 

/etc/hosts is not updated on dataless client 

Upgrade of kbus clients fails if config_servers used -n. 

Rebooting on ramdisk doesn't work properly. 

Install tries to newfs length partitions. 

/etc/rc.local assumes networksunview installed 

/etc/hostname.eiO is not updated on dataless clients. 

config_system doesn't get default netmask from inst_sys. 

Solpatch remove patch falsely succeeds when save dir missing. 

Incorrect Warning Message 

/usr/share/man/whatis is out of date 

non-NIS diskless clients get broken /etc/rc.local 

RPC interface to rstat functions improperly 

/usr/lib/libbsdmalloc.a missing from 4. IB 

cert advisory on sendmail CA:93-15 

1/23 tape: /etc/mtab is world-writable 

tools for monitoring per-cpu stats 

include fix for SunOS in.telnetd vulnerability 

portmap occasionally dumps core due to seg fault 

dump gives no errors but restore gives readhdr errors 

lookbib core dumps 

rcpgen as documented in man pages fails 

quota is not updated dynamicallyrc.local entry doesn't work 
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Bug# 


Component 


Subcomponent 


B9209 10004 


Utility 


Other 


B930303007 


Utility 


Other 


B930330001 


Utility 


Other 


B930416002 


Utility 


Other 


B930505002 


Utility 


Other 


B930520001 


Utility 


Other 


B930607001 


Utility 


Other 


B930610003 


Utility 


Other 


B930629001 


Utility 


Other 


B930629003 


Utility 


Other 


B930729001 


Utility 


Other 


B930830001 


Utility 


Other 


B930830003 


Utility 


Other 



Problem Summary 

dis -F does not work 

ftp reports bogus transfer rate 

sun patch 10061-01 

pgstat reports negative number 

dump can hang at 4.1b 

solpatch exits when installing all patches at once 

/usr/lib/expreserve may be used to trash any file 

uncomment savecore by default in /etc/rc.local 

request for sun patch 100249-07 

/etc/utmp is world-writable 

request for sun patch 100564-05 C2 Jumbo Patch in 4.1.2 

Solpatch misreports what spool directory it is using. 

Solpatch should report PATH being incorrectly set 
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SunOS 4.1.2 bugs fixed in Solbourne OS/MP 4.1C 

Sun Bugs Fixed in Solaris 1.1 

A number of Sun bugs were fixed by Solaris 1.1. This chapter lists the more significant fixes. 

Kernel/Driver Bugs Fixed 

Bug# Description 

1045 104 Fix for 1044867 (infinite BOGUS page loop) has a bug 

1062972 shared and exclusive, lock lists get munged; rpc.lockd cores 

1069493 Console driver can't display 8-bit characters 

1070964 ieO: output queue full; increased due to 600MP 

1071674 Sundiag 2.3 fails startup probing because of false devinfo inf 

1 0750 1 9 /usr/kvm/machine points to the wrong place 

1075332 dtop_drawcursor determines if colormap is a power of 2 incorr 

1076463 Insufficient kernel virtual space for large machines 

1077035 itrunc: /mnt/123598 new size = 0, blocks = -29376 messages pri 

1080630 Large 600MPs get "panic: out of virtual memory" 

1080842 environmental errors are ignored by the IPI driver 

1081482 kernel integer division emulation code does not deal with over 

1081618 $<traceall does not work on a sun4m 

1 082227 sdi V incorrectly emulated on 600MP/4. 1 .2 

1082539 sd: make_sd_cmd improperly clearing klustersort sort keys 

1082751 segment violation caused by sdiv, udiv 

1082782 sdiv emulation routine causes segfault under 4.1.2 

1083014 4. 1 .2 kernel does not emulate integer mul/div correctly 

1083 123 sun4m kernel fails if the mxusers is > 250 

1083662 4.1.x kernel doesn't support SPARC V8 recomputation 

1083810 LI -A sometimes ignored during panic 

108381 1 Kernel panics while syncing file system 
1083844 Force MMU Tablewalk after page fault 

1083892 kernel emulation code detects underflow after rounding 

1083917 4/690, 4/670 hangs, CPU lights freeze, when running with speci 

1 084235 max sun4m RLIMIT_DATA is too low 

1084676 Select best processor for a process 

1084680 Window Overflow missing a nop for psr delay 

1085152 Security: 600MP kernel has undocumented "probeme" trap 

1085165 Remove nonfunctional 4.x TLB locking code 

1085235 Prevent Cy7c605 from pagefaulting on M-bit update 

1085863 Panic: BAD TRAP in fp.disabled trap 

1 086 143 600MP system crashes with a watchdog reset - INSTRUCTION ACCE 

1086438 klock_exit blows away caller's %16 register 

1086458 console login prompt garbled when 8-bit chars are passed through 

1086685 adb doesn't disassemble sdiv instruction 

1086687 4.1.2 doesn't handle divide instructions 

1087264 atomic swap command fails only on IPC running 4.1.2 FCS 

1087507 system panics with "panic on 0: ialloc: dup alloc" 

1 088483 Security: 600MP shipped with halt_and_catch_fire 

1089128 rfs_lookup needs to release the directory vnode before error r 

1090435 nice'd processes hang in run state and aren't killable. 

1090849 datasize limited to 512MB 

1092548 under heavy load, "panic: swtch" 
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System Administration Bugs Fixed 

Bug# Description 

1033724 /usr/lib/adb belongs in /usr/kvm 

1081944 In 4.1.2, add_client and add_services fail to recognize DiskSuite 

1082294 sunupgrade ignores '#' in /etc/hosts when upgrading diskless c 

Network Bugs Fixed 

Bug# Description 

1063432 tip to RFS mounted serial port causes panic: data fault 
1076985 4/490 NFS client crashes when accessing mounted file from a no 

Library Bugs Fixed 

Bug# Description 

1072740 strcollO .... strxfrm() dumps core for locale >< C if stdin c 

POXrX (library) 

Bug# Description 

1032120 POSIX:l_pid in flock isn't a pid_t. 

1032755 errno should be set to EBADF on a number of library routines. 

1032777 fopen should return ENOENT for empty string. 

1037220 sigvvec can't examine action of SIKILL or SIGSTOP. 

1080635 execvp & execlp do not return ENOENT for null path. 

POSIX (Kernel) 

Bug# Description 

1029856 Open 0-length file with 0_TRUNC; doesn't update st_ctime and st_mtime. 

1032784 fpathconf on unopened tty needs to return a value to pass PCTS. 

1039505 Trailing / in pathname should be ignored. 

1077642 Kernel rprts wrong SIMM loctn when ECC bit 

1087606 heap fragmentation hangs brk() 

1081728 write system call fails even if there are some bytes available. 

1081740 Pending sigchld is not ignored if handler set to default. 

2000582 POSIX settable test gets wrong value when PARENB and PARMARK set. 

2000794 Check for maxuproc is off by one. 

2001524 zs driver shouldn't have high bit set in CS5 mode. 
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Link-editor Bug Fixes 

Bug# Description 

1019004 assert definitions can fail to report undefined symbols 

1032739 Id core dumps with many libs in multiple directories 

1034788 -r and -pic do not mix bad secondary magic number error 

1034833 Id: can't mixed -r with -Bstatic or -A flag 

1037879 Cannot create executable with shared object which points to another shared object. 

1041946 (duplicated by 1065275, below). 

1 04226 1 Id only recognized first directory in LD_LIBRAR Y„PATH 

1044524 multiply defined symbols and seg. fault caused by 4.1 's Id 

1045272 Id -u & -r do not seem to work properly 

1046462 Id fails with segmentation fault when processing nested #include files 

1050594 fix uninitialized structure entries. 

1064820 Id can produce bogus diagnostics when processing cascaded dependencies 

1065275 program dumps core with shared objects having only statics. 

1033086 Calling dlopen() on a file with ESS kills your application. 

1043300 dlclose prevents access to functions even after further dlopen 

1045 194 dlsym returns bad address for uninitialized global variable 

1046379 cannot call a function in a [.so] from a function in another 

1052428 Id.so usage of -L options confusing, leads to security probs 
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Patches Included in OS/MP 4.1C 
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Solbourne OS/MP 4.1B patches in OS/MP 4.1C 

Patch# Bug# Description 

p93012501 B92121 1001 Fix for data fault and lock error panics 

p93012601 B930126001 Fix for hang in choose_process and loss of wakeup 

p93012602 B930126002 Fix for anon.decref panic 

p93012603 B9301 13002 Fix possible deadlock when an asynchronous memory error occurs 

p93020101 B921 1 12001 Fix for ttycommon.qfull kernel read fault 

p93020102 B921010001 Fix for panic with kmem_free: block already free 

p93020103 B921 1 19001 Fix for spurious interrupts causing panic 

p93020 1 04 B92 1 1 3000 1 Exiting sun view can hang console. 

p93020105 B921217005 mount system call has bad check for uap->type. 

p93020201 B92 121 8001 fix lock error panics when using unix domain sockets 

p93020203 B930 106002 fix for CDROMSUBCHNL ioctl call to sr driver 

p93020204 B930202002 jumbo patch to integrate CTE fixes to libcurses (equivalent to Sun patch 100408-01) 

p93020205 B930202003 csh memory leak tty gets EOF condition (equivalent to Sun patch 100399-02) 

p93020206 B930202004 tar fills last block of tarfile with unrelated data (equivalent to Sun patch 100413-01) 

p93020207 B930202005 add code to grab MMU information during panic or NMI 

p93030501 B930305005 ipcs aborts with "shcmtl: Permission denied" (equivalent to Sun patch 100650-01) 

p93030801 B930301001 fix for lock timeout or system hang with Series6 CPUs 

p93030901 B930309001 fix for dump to tape 

p93030902 B930309002 socketpair system call was not setting syscall return value 

p93031001 B930310002 fix kernel printf for memory address alignment fault 

p93031002 B930310001 fix for lock semaphores lock violation 

p93031003 B9303 10005 change ufs sync to minimize response time 

p9303 1201 B930202001 add support for RORA VME controllers 

p93032201 B9303 1 8002 fix for choose_process panic 

p93032202 B930318007 NFS Jumbo Patch (equivalent to Sun patch 100173-10) 

p93032601 B930318004 kernel can possibly generate duplicate pids (equivalent to Sun patch 100636-01) 

p93033001 B930330001 cron dumps core & cron dies when daylight savings time (equivalent to Sun patch 100651-01) 

p93033002 B930323002 RFS Server patch, (equivalent to Sun patch 100684-02) 

p93033003 B930301004 software fix for detecting possible hung lance ethernet chip 

p93040101 B930330003 fix for socket poll panic 

p93041201 B930412003 increase hash table size (equivalent to Sun patch 100606-03) 

p93041301 B930413001 rdist security and hard links enhancement (equivalent to Sun patch 100383-06) 

p93041601 B930416001 fix for sd_unit panic 
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Patch# 

p93041901 
p93042001 



Bug# 

B930331001 
B920925003 



p93042002 B920925003 



p93050601 
p93050602 
p93051401 
p93051701 
p93052601 
p93052701 
p93052801 
p93060401 
p93061001 
p93061002 
p93061101 
p93061102 
p93061401 
p93062101 
p93062102 
p93070101 

p93070201 
p93071301 

p93071601 

p93071901 
p93073001 
p93081001 

p93081101 
p93081102 
p93081201 
p93081301 
p93081302 
p93081901 
p93082301 
p93082501 
p93090701 
p93090801 
p93091301 



p93091302 
p93091401 
p93092101 
p93092201 



B9301 18001 
B930505003 
B930505002 
B930505002 
B9305 11001 
B930520001 
B930519001 
B930525002 
B9303 18006 
B930607001 
B930608001 
B930526001 
B930426001 
B921216001 
B930607001 
B930416002 
B930608001 
B930630002 
B930607001 

B930224005 

B930713005 

B9307 12002 

B930630002 

B930408002 

B9305 12003 

B930729001 

B930708001 

B930629001 

NONE 

B920814014 

B930817001 

B930528001 

B930526002 

NONE 

B9305 12002 

B930522002 

B930522001 

B930820001 

B930901002 

B930706001 

NONE 

B9309 14002 



Description 

Jumbo tty patch (equivalent to Sun patch 100513-02) 

TCP "reset"s can cause an mbuf leak, resulting in mbuf map full 

(equivalent to Sun patch 100804-01) 

mbuf + mcl_static cluster mbuf should be protected from interrupts 

(equivalent to Sun patch 100456-04) 

fix race in close 

fix for select on socket hang 

fix copy from kernel to user space 

fix zeroing from kernel to user space 

UFS Jumbo Patch (equivalent to Sun patch 100623-03) 

fix for Solpatch inability to install more than 26 patches at one time 

TMPFS Jumbo Patch, v2 (equivalent to Sun patch 100507-04) 

fix named pipe panic and data corruption (equivalent to Sun patch 100347-03) 

vm_context lock timeout in klustsort() 

expreserve can trash files and give root access 

fix for FDDI hangs 

fix for lock error panic when LOCK_STYLE is debug 

fix for store buffer exception 

Id.so write buffer flush 

security problem with expreserve (equivalent to Sun patch 101080-01, and obsoletes Solbourn) 

fix for FDDI hangs 

fix for Data Fault Panic in Accept 

security problem with expreserve, secure installation (equivalent to Sun patch 101080-01, 

and obsoletes Solbourn) 

wrong MAKEDEV line for /dev/tcp 

incorrect results or SIGSEGV in emulated instructions 

fix for lock problem 

fix for panics in ckuwakeupO, panic 'getting user pte from interrupt' ... 

C2 Jumbo Patch (equivalent to Sun patch 100564-05. Due to the editin) 

pstat chokes on greater than 10,000 file descriptors 

automount Jumbo Patch (equivalent to Sun patch 100249-07) 

kernel support for 40 MHz Series6 CPUs 

avoid swapping a process allocating page tables 

"at" jobs are not running; job files are being over-written, (equivalent to Sun patch 100972-01) 

exit of suntools from SunView causes panic: bad rmfree (equivalent to Sun patch 100666-02) 

fix 'block_n_lock' on single CPU system 

tfs does not work with auditing enabled (equivalent to Sun patch 100372-02) 

kernel memory fragmentation causes processes to hang in D state 

fix Data Fault Panic, Invalid PTE Panic, Lock Timeout in update() 



fix for panic in exit 

keep consistent RSS statistics 

feneralized clock speed support for Series6 

prevent kernel memory pool corruption due to i/o error in ufs_getsummaryinfo 
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Patch# 

p93092901 
p93 100401 
p93 102801 
p93 110801 
p93 120201 
p93 120601 
p93 120901 

p93 121601 
p93 122301 
p94010701 



Bug# 

B930928001 
NONE 
B920929003 
B93 1005001 
B93 1124002 
B93 1108002 
B93 1209001 
B93 1205001 
NONE 
B93 1021001 
B9308 13002 
B93 11 16003 
B931217001 



Description 

fix Data Fault panic that may occur after mbuf map full 

data fault using ROM output routines 

emulating integer multiply /divide instructions gets SIGILL or SIGSEGV 

lock timeout in pvn_vptrunc 

accounting Jumbo Patch (equivalent to Sun patch 100407-07) 

Killing and restarting nfsd causes memory address align panic. 

FDDI Deaf Receiver problem, incorrect Driver Stats, and related problems 

Prevent ARP entries from running off the end of the arp table. 

sendmail jumbo patch with security fixes (equivalent to Sun patch 100377-08. It replace) 

Fix FDDI related DVMA map corruption 
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SunOS 4.1.2 patches in Solbourne OS/MP 4.1C 



Patch# 


Bug# 


100075-08 


1040406 


100075-08 


1046373 


100075-08 


1063692 


100075-08 


1064183 


100075-08 


1071435 


100075-08 


1074757 


100075-08 


1077402 


100075-08 


1080359 


100188-02 


1070495 


100224-03 


1051832 


100274-02 


1044478 


100371-01 


1044726 


100381-01 


1068938 


100384-01 


1063432 


100399-01 


1066556 


100402-01 


1069046 


100408-01 


1047916 


100408-01 


1070312 


100425-01 


1055736 


100431-04 


1063683 


100431-04 


1068120 


100431-04 


1073137 


100431-04 


1073181 


100431-04 


1074981 


100431-04 


1080766 


100431-04 


1086669 


100453-01 


1073672 


100456-03 


1075220 


100469-01 


1039388 


100474-01 


1074337 


100475-01 


1073234 


100484-01 


1078167 


100490-01 


1080928 


100494-01 


1074704 


100494-01 


1074822 


100495-01 


1074424 


100505-01 


1078521 


100507-01 


1038651 


100511-01 


1082046 


100516-01 


1077539 


100520-01 


1031907 


100521-01 


1080702 


100534-01 


1083022 


100536-01 


1066287 


100537-01 


1069770 


100537-01 


1073679 



Description 

KLM protocol changed but RPC versn # wasn't 
shared or exclusive lock doesnt work on 412 
deadlock is not detected in nfs locking 
downgrading a lock doesnt grant other read 
panics: corrupt file lock list 
rpclockd in 4.1.2 grows to few MB (leak) 
file can get left locked by exited process 
Read lock gets stuck in the kernel lock 
pgms using pty can get output from prev ap 
rmail dumps core on certain (unknown) errs 
dup biodone related panics w ... 4.1.1 
showfh timeouts before accessing nfs fh 
du does not work with VMS(NFS) filesystem 
tip to RFS mounted serial port causes pan 
csh malloc mem leak results in Mem Fault 
cron dumps core on what appears to be corre 
keypadO misinterprets function keys when 
terms ins/del line and scroll region cap 
whois is getting host unknown when it uses 
back facing hollow polygon inconsistent w 
Undrawing antialiased lines in QUM mode ha 
Back-faceed QUADS are slow on GT when FACE 
Performance degrades for polygons follow 
color sometimes incorrect for clipped, dep 
Non-dot markers are slow 
Performance problem - short triangle 
Increase 1.5MB DVMA window avail to GT 
mcldup doesnt block interrpts causing mbuf 
cdrom mount error message 
format: ass failure on 1 .3G elites on sun4 
mmap sys call fails on galaxy causing unex 
SCSI driver for micropolis drive produces 
nl_langinfor(YESSTR) of libxpg.a caused co 
WIDs are freed when eg 12 contexts are dest 
munmap'ing ctl register page clobbers shme 
Sybase datasrvr crashes 4m (ER) - xc_atten 
Zero length directories can be left when 
Using tmpfs ie ram /tmp can cause data ini 
SunDiag cg6test failed on seg violation 
increase HEAPBYTES 
cron dies when daylight time starts, stop 
4/75GT crash when executing screenload ... 
nettest dies w Seg Violation on 4.1.2FCS 
nfs hang when looking at Ig file changed on 
swapper hangs waitng fr pg of u-area to co 
async i/o peaks can hang system (gen) 
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Patch# 


Bug# 


100539-01 


1085014 


100542-03 


1063059 


100542-03 


1077801 


100547-01 


1079876 


100569-01 


1072183 


100569-01 


1083997 


100570-01 


1085043 


100575-02 


1080798 


100591-01 


1089381 


100597-01 


1075751 


100618-01 


1074668 


100636-01 


1082229 


100642-01 


1089250 


100654-01 


1090369 



Description 

umount of busy hsfs fs succeeds causing pa 
ipi driver doesn't return en- 
galaxy with cg6+presto crashes on ipi 
fputest kvm_open failed 
gttest takes too Ing to rpt Firmware fail 
mouse freezes running OW3.0 apps on GT 
net jammed" messages annoy the user 
IPI runs slower on a 4/670 then a 4/470 
nimp_ins trap trashes %g[123] on MP systems 
VME dropped INT_ACK cycle 
kernel panics when running sunvision 1.1 
fork creates duplicate PIDs 
TLI hangs running on Sun-MP 4/690 running 4.1.2 
It takes a long time to terminate a big process. 
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SunOS 4.1.3 patches in Solbourne OS/MP 4.1C 

Patch# Description 

100075-11 rpc.lockd jumbo patch 

100170-10 jumbo patch to fix various Id problems 

100173-10 NFS Jumbo Patch 

100178-08 inetd "broken server detection" breaks on fast machines 

100224-06 program "mail" "rmail" problem in delivering mail; mail signal handlers cause recursing buss errors 

100249-08 automounter jumbo patch 

100283-03 in.routed mishandles gateways, multiple 

100296-04 netgroup exports to world 

100305-13 Ipr Jumbo Patch 

100338-05 system crashes with assertion failed panic 

100342-03 NIS client needs long recovery time if server reboots 

100347-03 panic's when using fifo's (named pipes) under load 

100359-06 streams jumbo patch 

100372-02 tfs and c2 do not work together 

100383-06 rdist security and hard links enhancement 

100407-07 accounting jumbo patch 

100412-02 applications bind to same port if IP address supplied 

100458-03 Setitimer sometimes fails to deliver 

100468-03 rcp/rsh should use setsockopt to detect failed connection rsh uses old-style selects instead of 4.0 selects. 

100482-04 ypserv and ypxfrd fix, plus DNS fix 

100496-02 ptrace panic with a memory fault 

100507-04 tmpfs jumbo patch 

1 005 1 3^02 Jumbo tty patch 

1 00557-03 ftp Jumbo patch 

1 00564-05 C2 Jumbo patch 

100567-04 mfree panic due to mbuf being freed twice, icmp redirects can be used to make a host drop connections 

100584-03 system freezes using loopback interface, BSD4.2 keepalive 

100623-03 UFS Jumbo Patch 

100631-01 environment variables can be used to exploit login 

100645-01 swapon with very large swap files hangs, systems temporarily hangs while a large process exits 

100650-02 permission denied" 

100666-02 bad rmfree 

100671-02 TLI causes application program to hang, and TLI subsystem does not handle certain lOCTL calls. 

100684-02 RFS server patch 

100689-01 large processes hang in "disk wait" when they're trying to grow their data size with brk(2) 

100783-01 ptrace panic with a memory fault 

100804-01 TCP "reset"s can cause an mbuf leak, resulting in mbuf map full 

100813-01 memory leak in parser generated by yacc 

1008 15-01 point patch for uucp with callback option 

100909-01 syslog messages get confusing because it does not specify which machine sent it. 

1 00937-0 1 NULL CLIENT 

100965-01 quota exceeded console messages misleading 

100972-01 "at" jobs are not running; job files are being over- written. 

100988-01 Synopsis: UFS File system Corruption and panic patch 

101070-01 tbl may dump core on sun-4; ok on sun-3. 

101073-01 vacation(l) does not recognize aliases of the type firstname.lastname. 

101080-01 security problem with expreserve 
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Before Installing.... 



Installing preinstall 



Installing OS/MP 4. IC 
on a Standalone System 



The OS/MP 4.1C software tape is a full installation media that allows you to update 
from a previous release, change the size of partitions on the root disk, add a disk to 
a previously diskless system, or configure a standalone system. 

A standalone system is defined as not being connected to a network in any way. In 
addition, a standalone system does not provide NFS disk services to clients. It also 
does not depend on a server for its root, swap, or /usr filesystems. 



* * * CAUTION * • • 

Perform a full backup before installing OS/MP 4.1C. A complete installation 
overwrites all information on the disk partitions specified for the root (/), 
swap, /usr, /var, and /tmp filesystems. 

Before instaUing the release tape you must clean the tape drive on the host ma- 
chine. Failure to do so may result in damage to the release tape. 

With OS/MP 4.1C, the preinstall utility is available to help determine which sys- 
tem files should be restored or merged from backup, preinstall shows which files 
in system directories were modified after you last installed the OS version you're 
currently running. 

If you do not want to use preinstall, skip to the section Installing below. 



Because preinstall was not included in versions of OS/MP prior to 4.1C, it is nec- 
essary to install it before proceeding to install OS/MP 4.1C. 

When using a local tape drive, install preinstall using the following commands: 



/^# mt -f /dev/nrstO asf 5 

# cd /usr/etc 
^^# tar «p£ /dev/nrstO 
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* * • NOTE * -ySr -A- 

Some older versions of SunOS do not support the 'asf request for mt. If this is the 
case for your tape host, first substitute 'rew'for 'asfS' in the above example, and 
then re-execute mt with fsf5' instead of 'rew'. 

When using a local CD-ROM drive, install preinstall using the following com- 
mands: 

/^# xnkdir /cdrom — — ——. 

# mount /dev/srO /cdrom 

# cd /usr/etc 
l ^# tar acpf /cdrom/Tools«tar 

Using preinstall 

After preinstall has been installed, it is located in /usr/etc. The usage of preinstall 
is as follows: 

/usr/etc/preinstall [ -1 ] [ -c mmddhhmm[yy] ] 

The preinstall command is used to look for files that should be saved prior to doing 
a full install of a new version of OS/MP. It looks on the system partitions (root(/), 
/usr, and /var) for files which have been modified after the date of the last full in- 
stall of OS/MP (or, if given a cutoff date, files modified after that date). 

preinstall is normally used just before installing a new version of OS/MP to deter- 
mine what system-related files should be backed up. Then, after installing the new 
version of OS/MP, you can merge or restore these files into the newly-installed sys- 
tem. 

Some files, such as /etc/fstab, can typically be re-used without modification. Oth- 
ers, such as kernel configuration files in /usr/kvm/sys/*/conf, must be hand- 
merged into the new version of the OS with careful consideration of how the new 
OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. 
These files are normally updated by system operation and do not need to be backed 
up. Examples of excluded files are: /etc/mtab, the /var/sadm accounting files, the 
/tmp_mnt automounter directories, and patched kernel object files in 
/usr/kvm/sys/*/OB J. By default, the cutoff date used is the modification date of 
the file /etc/sys_conf^system-configured, which is touched the first time you boot 
a new version of the OS after a full install. You may want to use some other cutoff 
date with the -c option if the current OS was installed in some non-standard way. 

By default, the files and directories newer than the cutoff date are listed to standard 
output by name, one per line. By using the -1 option, the output is in long form (as 
from the -Is option to find), showing the type, date, and size of each file. 
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The following options are accepted by preinstall: 

□ The -1 option presents the output in long form, showing inode number, size in 
kilobytes (1024 bytes), protection mode, number of hard links, user, group, 
size in bytes, and modification time. If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic 
link the pathname of the linked-to file is printed preceded by '- >'. The format 
is identical to that of find -Is. 

□ The -c option specifies to use the given cutoff date to decide which files to 
print, rather than the date of the file /etc/sys_conf/system-configured. The 
cutoff date format is -c mmddhhmm[yy], with month, day, hour, minute, and 
optional year in numeric form. This is the same format as for/usr/Sbin/touch. 



Installing 



Installing on a Series5, 
SeriesSE or Series6: 



Loading the ramdisk image is your first step. The ramdisk image is a special UNIX 
operating system kernel with a built-in RAM disk that contains the installation soft- 
ware. The command to load the ramdisk depends on the type of system. Follow the 
instructions for your system type. 



Loading the Ramdisk 

Tum the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

Loading the Ramdisk via a Local Tape Drive 

Ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



( ROM> setenv installed 



I 



The system asks if you want to re-install if INSTALLED is not 0. 

The variable TapelD shown in the commands below should be replaced with the 
SCSI ID of the tape drive to be used. For stO, use 4; for stl, use 5. 

To load the ramdisk on SeriesS or 5E systems, enter a boot command of the follow- 
ing form: 



( ROM> boot St « si ( , TapelD, 2 } 



To load the ramdisk on Series6 systems, enter a boot command of the following 
form: 



3 



( I10M> boot St . si {, yapell?, 3) 



J 
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The Series6 bootROM copies the ramdisk image into memory and boots it: 

"Boot: St -si (,4,3) 
Entry: OxfdOSOOOO 

Size: 00xea000+0x43b878+0x3a9f0 

V , _____„ ___„ . . y 

The system displays spinner while it is copying the ramdisk into memory. When 
the copy completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

Ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



r"^Biiiiiiiii|^^ 



I 



The system will ask if you want to re-install if INSTALLED is not 0. 
Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

* * • NOTE • • • 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
3.5 or higher. 

To load the ramdisk on SeriesS, and SeriesSE systems, using a local CD-ROM 
drive, enter a boot command of the following form: 



(^ROM> boot sd. si(, 6, ) /Install. SeriesS 



• 



To load the ramdisk on Series6 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 



i 



(^0M> boot sd.si(/ 6,)/ Install. SeriesS 



The bootROM copies the ramdisk image into memory and boots it: 

(^Boot: sd-si{,6, ) /Install .Series6 _™~_ 

Entry; OxfdOSOOOO 
^Size: 00xea000+0x43b8b8-f0x309a8 ^ 

A spinner (oscillating long-dash line) is displayed while copying the ramdisk into 
memory. When the copy completes, there is a pause of up to three minutes. 
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Diskful Installation 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, the system displays a list of supported 
terminals: 



ft) 610 ■ ■ 

2 ) ansa. 

3) hp 

4 ) sun 

5) tviSia 

6) vtlOO 

7) wyseSO 
What type of terminal are you using (^1', *'?')? 

If you are using a frame-buffer, select the 4, the sun terminal type. 

( What type of terminal are you using (-l-..'7-)?4 ' ) 

If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 

"this system is already installed ~ ~~" 

Do you want to re-install the system {^yes', ^no' , or ^?' 
; for help) ? 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable, as described pre- 
viously. 

If the message appears, enter yes to re-install the mandatory system software, or 
no to continue installing software without re-installing mandatory OS/MP. 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



Ramdisk 

1) Change Disk Partitioning 

2} Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 

Enter number of function to execute ('1'..''5', or ' ? ' for 
^help) : J 

The provided functions are described below: 

Change Disk Partitioning - Allows changing the sizes of disk partitions, and 
where those partitions are to be used for, filesystem space, swap space, or unused 
space. Refer to the section titled "Changing Disk Partitioning". 

* * * NOTE * * • 

If changes are going to be made to the disk partitions on which OS/MP 4.1C will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesy stems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 
select Change Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts the UNIX operating system after software installation. Al- 
ternatively, you may reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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You can request help at any ramdisk prompt by entering a question mark. Table 14 
shows the edit commands available when you are entering text in response to 
prompts: 



Table 14. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete (^?) 


delete last input character 


'^U 


erase input line 


'^R 


redisplay input line 


A^ 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return C^M) 


end input 


newline {^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



lillllliliipliilli^^ 
||g||j|||j|||i|| 

iiiliHilililM^ 



where ^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been gathered. 
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The system uses three informational menus to gather the necessary information: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

O Installation Media Identification - Determines the installation media from 
which to install (tape, CD-ROM, or network directory), and determines where 
that media is located. 

O Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition Menu defines where the mandatory filesys- 
tems are located. 

Any changes made to the standard filesystems with the partition tool appear in this 
menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification Menu, enter 'continue'. 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 1, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 

To modify the /var filesystem, enter the number: 4. 

Enter number of filesystem to change ( ' 1 ' . . ' 5 ' ) , ' continue' , 
^previous', ^cancel' or ^1' for help: 4 
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Standard Filesystem Definition 



1} root on sdOa (re<3uired) 

2} swap on sdOb (required) 

3) /usr on sdOg (required) 

4) /var on root partition 

5) /tmp on root partition 









Disk Partitions (sizes 


in MB) 








(a) 


(b) 


(c) (d) (e) 


(f) 


<g) 


(h) 


sdO: 


8.4 


32.4 


191.1 9.3 





141.1 





Sdl: 


8.4 


32.7 


190.9 9,6 





140.8 






Enter number of filesystem to change { '1' . . ''5' ) , ''continue' , "previous' , 
'cancel', or '?' for help: 



Figure 1. Sample Standard Filesystem Definition Menu 

The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 

Enter name of disk partition or host:path for /var 
filesystem, 'none', '^C, or'?' for help; sdOd 

The new arrangement is displayed as shown in Figure 2. 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Installation Media Identification Menu. 

/^Enter number of filesystem to change { ^1 ' . . ' 5M / 'continue' , 
I 'previous', 'cancel', or '?' for help: continue 

Installation Media Identification Menu 

The Installation Media Identification menu specifies the location of the media 
which will be used during the installation. 

Figure 3 shows the Installation Media Identification menu of a machine that was 
booted from a local tape device stO (SCSI address 4). 

Installation may take place from Tape or CD-ROM. Each of these installations are 
discussed below. 
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1} root on sdOa 

2) swap on sdOb 

3) /usr on sdOg 

4) /var on sdOd 

5) /tmp on root partition 



Standard Filesystem Definition 

(required) 
(required) 
(required). 





(a) 


(b) 


sdO: 


8.4 


32.4 


sdl: 


8.4 


32.7 



Disk Partitions (sizes in MB) 
(c) id) (e) (f) 

191.1 9.3 
190.9 9.6 



(g) 

141,1 
140.8 



(h) 



Enter number of filesystem to change 
'cancel', or *?' for help: 



{'1 



5'), "continue'/ 'previous' 



Figure 2. Modified Standard Filesystem Definition Menu 



Installation Media Identification 

1) Installation media type ~ Tape 

2) Tape drive = /dev/nrstO 

3) Local Internet address == 0.0.0.0 (required for remote tape) 

4) Network broadcast mask = OxffffOOOO (required for remote tape) 

5) Tape host = localhost (127,0.0.1) 



Enter selection number (*1'..'5')-, * continue', ^previous', 'cancel'-, or '?'for 
help; 



Figure 3. Installation Media Identification Menu - Local Tapehost 
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Tape Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to ' local - 
host'. The Installation media type must also be set to 'Tape'. 

Local CD-ROM Installation 

• Installing from a local CD-ROM disk drive requires that the Installation 
media type be set to CD-ROM, the CD-ROM drive field be set to 
/dev/srO (/dev/srl if installing from sv2 on a Cougar controller) 
and the CD host field be set to 'localhost'. Figure 4 shows the Instal- 
lation media type menu with the CD-ROM parameters set to install from 
CD-ROM. 



Installation Media Identification 

1) installation media type « CD-ROM 

2) CD drive = /dev/srO 

3) Local Internet address = O.O^O.O (required for remote tape) 

4) Network broadcast mask « OxffffOOOO (required for remote tape) 

5) CD host == localhost (127, 0> 0.1) 



Enter selection number (*!'.. '5')/ ^continue', ^previous', ^cancel', or '?^for 
help: 



Figure 4. Installation Media Identification Menu - Local CD-ROM 

When the details of the media have been entered correctly, enter continue. You 
will be presented with the Package Selection Menu. If the operating system has al- 
ready been installed, you will be prompted to insert the optional software distribu- 
tion media. 

Package Selection Menu 

Use the Package Selection Menu to install optional Solboume software distribu- 
tions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 
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The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solbourne OS/MP Optional Software, is included on the OS/MP 
4.1C distribution tape. The following display shown in Figure 5 appears; the values 
shown for Size in this and subsequent displays may vary. 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size ^ KB) Install 

1) Solbourne OS/MP 4.1C Optional Software 34832, n 



Enter number of package to examine n 
for help: 



1'), * cancel', ^install', or *?- 



Figure 5. Package Selection Menu 



The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 
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The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 



^Enter number of package to examine ('!'.<. ^1'), 'cancel', 
'installs or '?' for help: 1 

Should the Solbourne OS/MP 4,1C Optional Software package 
be installed {'yes', 'no' , "^C, or '?' for help)? yes j 

The "Should the Solbourne OS/MP 4 . IC Optional Software 
package be installed" question refers to the entire package in general. 
The modules are individually selected for installation on the customization screen, 
and by default all are selected for installation. 

After replying yes, the customization menu appears as shown in Figure 6. 



* • * NOTE * * • 

Figure 6 is only an example. The Free KB reported varies depending on the type 
and size of disk drive installed. 



Customization 


of Solbourne 


OS/MP 4.1C Optional 


Software- 






Software Modules 




Module 


Size (KB) 


Install 


Directory 


Free {KB) 


1} DEBUGGING 


2888 


y 


/usr 


S8695 


2) GAMES 


3X36 


y 


/usr 


58595 


3) MANUAL 


6992 


y 


/usr 


58695 


4} NETWORKING 


1096 


y 


/usr 


58695 


5 ) PLOT 


1784 


y 


/usr 


58695 


6) SECURITY 


320 


y 


/usr 


58695 


7) SV_PROG 


1848 


y 


/usr 


58695 


8) SV_USER 


3144 


y 


/usr 


58695 ' 


9) SYSTEM^V 


3992 


y 


/usr 


58695 


10) TEXT 


728 


y 


/usr 


58695 


11) VERSATEC 


5960 


y 


/usr 


58695 


12) UUCP 


608 


y 


/usr 


58695 


13) RFS 


912 


y 


/usr 


58695 


14) SHLIB 


1376 


y 


/usr 


58695 


15) TLI 


48 


y 


/usr 


58695 



Enter number of module to modify {'l'..U5'), 'continue'/ 'abort', or '?' for 
help: 



Figure 6. Package Selection Customization Menu 
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The size of each module in kilobytes is listed immediately to the right of the mod- 
ule' s name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING ■ program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) orftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SAfP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY -C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling Sun View applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic Sun View support 

The Sun View windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible Ubraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 
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TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC " Versatec printer support 

Various utilities specific to Versatec printers, i.e. vtroff(l) and vpIot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 
to other UNIX systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C Hbrary. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• • * NOTE * • * 

All modules are intended to be extracted into their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, if you didn't want to install the VERSATEC module: 

Enter number of module to modify ('1'..'15'), 'continue', 
'abort', or 'T'lfor help: 11 

The VERSATEC menu entry is highlighted, and: 

''^Modifying the Versatec printer support module 
Should the VERSATEC module be installed {'yes', 'no', ""C, 
or ' ? ' for help) ? no J 

Figure 7 shows the updated display: 

• • • NOTE • • • 

The free space for Aisr has been increased by the size of the VERSATEC module 
as shown in Figure 7. 

To install the GAMES module in /fun (on the root partition): 

Enter number of module to modify {'!'.. '13'), 'continue', 
'abort', or '?'^for help: 2 
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Customization of Solbourne OS/MP 4.1C Optional Software. 



Software Modules 



Module 


Size (KB) 


Install 


Directory 


Free {KB) 


1) DEBUGGING 


2888 


y 


/usr 


64655 


2) GAHES 


3136 


y 


/usr 


64655 


3) MflJSUAL 


6992 


y 


/usr 


64655 


4) NETWORKING 


1096 


y 


/usr 


64655 


5) PLOT 


1784 


y 


/usr 


64655 


6) SECURITY 


320 


y 


/usr 


64655 


7) SV_PROG 


1848 


y 


• /usr 


64655 


8) SV_USER 


3144 


y 


/usr 


64655 


9} SySTEM„V 


3992 


y 


/usr 


64655 


10). TEXT 


728 


y 


/usr 


.64655 


11} VERSATEC 


5960 


n 






12) UUCP 


608 


y 


/usr 


64655 


13) RFS 


912 


y 


/usr 


64655 


14) SHLIB 


1376 


y 


/usr 


64655 


15) TLI 


48 


y 


/usr 


64655 



Enter number of module to modify :(U' . . ''15' ) , 'continue' 
help: 



^ abort', or '?' for 



Figure 7. Package Selection Menu - Deletion of Versatec Module 
The GAMES menu entry is highlighted, and 

/^Modifying the games and demonstration programs module . 

Should the GAMES module be installed ('yes', 'no', '^C, or 
' ? ' for help) ? yes 

Install GAMES in what directory? /fun 

/fun does not exist. Create it during installation {'yes', 
'no', -^C, or '?' for help)? yes y 

The menu is updated to reflect the change, as shown in Figure 8. 

* * * NOTE * * • 

The free space for Aisr changes, and a completely new size (forAun) is also dis- 
played as shown in Figure 8. 

If you decide to discard all changes made to the modules, use the command 
'abort'. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand 'continue'. This will record the changes and return to the Package Selec- 
tion Menu. 

When you have completed package customization, (which may mean you didn't 
select any packages for installation), enter 'install' as shown in Figure 9. 
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Customizatiou of Solbourne OS/MP 4.1C Optional Software 



Software Modules 



Module 


Size (KB) 


Install 


Directory 


Free (KB) 


1) 


DEBUGGING 


2888 


y 


/usr 


67791 


2) 


GAMES 


3136 


y 


/fun 


4579 


3) 


MANUAL 


5992 


y 


/usr 


67791 


4) 


NETWORKING 


1096 


y 


/usr 


67791 


5) 


PLOT 


1784 


y 


/usr 


67791 


6) 


SECURITY 


320 


y 


/usr 


67791 


7} 


SV_PROG 


1848 


y 


/usr 


67791 


8} 


SV_USER 


3144 


y 


/usr 


67791 


9) 


SYSTEM_V 


3992 


y 


/usr 


67791 


10} 


TEXT 


728 


y 


/usr 


67791 


11} 


VERSATEC 


5960 


n 






12} 


UUCP 


608 


y 


/usr 


67791 


13) 


RFS 


912 


y 


/usr 


67791 


14) 


SHLIB 


1376 


y 


/usr 


67791 


15) 


TLI 


48 


y 


/usr 


67791 



Enter number of module to modify {U'..'15'), 'continue'^ 'abort' ;, or ^?' for 
help: 



Figure 8. Package Selection Menu - Install Games Module to /fun 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1) Solbourne OS/HP 4.1C Optional Software 34832 y 



Enter number of package to examine ( ' 1 ' . . ^ 1 ' ) / 
for help: install 



' cancel ' 



install' 



or ^?' 



Figure 9. Package Selection Menu 
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The actual installation begins at this point, and may require 10 minutes to one hour 
depending on how much software is being installed. 



The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 10). If 
the installation failed, call Customer Support. 



Ramdisk 



1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Enter number of function to execute {'I'-.'S', or *?' for help}: 4 



Figure 10. Ramdisk Menu 

Rebooting from the Ramdisk 

After a successful installation, start UNIX by first rebooting as shown in 
Figure 10. 



Enter number of function to execute ('r..'5', or '?' for help): 4 
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Reboot Syst;em 



1) Boot Unix 

2) Boot on raradisk 

3} Return to Main Menu 



Enter selection number {^1'..''3') or '?' for help: 1 



Figure 11. Reboot System Menu 



At the Reboot System menu select Boot Unix: 

( ^ Enter selection nunxber {'X'..'3M or '?^ for help: 1 J 

After selecting 1, there is a short pause, and then: 

r Automatic boot enabled. Type Control-C to abort 
ROM> boot 

Boot: sd.si (0, 0, 0) /vmunix 
Entry: 0xff060000 
Size; 0xd6000+0x33358+0x81548 



OS/MP 4.1C_Export (GENERIC /root) #0: Tue Feb 1 15:52:44 

1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 

Solbourne Computer, Inc. 



At this point, the system configuration information must be specified. 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4.1C_Export (GENERIC/ root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 19.89-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas:! done. 

This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix . 



What is this system's name (default 
<Return> 



'Standalone' ) 



What is its Internet address (0 for none, default = 
255.255.255.255)? <R6ttim> 

What directory should be used for automatic savecore files 
('none' for none, default = Vvar /crash/standalone' ) ? 
<Retum> 



* * * NOTE * * • 
Using the value '0' for the Internet address disables the NIS/YP services. 
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Time zone 


choices are: 




Australia/ 


GMT+11 


GMT- 3 


Brazil/ 


GMT+1 2 


GMT- 4 


CET 


GMT+1 3 


GMT- 5 


CST6CDT 


GMT+2 


GMT- 6 


Canada/ 


GMT+3 


GMT-7 


Chile/ 


GMT+4 


GMT- 8 


Cuba 


GMT+5 


GMT- 9 


EET 


GMT+6 


GMTO 


EST 


GMT+7 


GMTl 


EST5EDT 


GMT+8 


GMTIO 


Egypt 


GMT+9 


GMTll 


Factory 


GMT-0 


GMTl 2 


GB-Eire 


GMT-1 


GMTl 3 


GMT 


GMT- 10 


GMT2 


GMT+0 


GMT- 11 


GMT3 


GMT+1 


GMT- 12 


GMT4 


GMT+10 


GMT -2 


GMT5 



GMT 6 


Mideast/ 


GMT7 


NZ 


GMT 8 


Navajo 


GMT9 


PRC 


Greenwich 


PST8PDT 


HST 


Poland 


Hongkong 


ROC 


Iceland 


ROK 


Iran 


Singapore 


Israel 


Turkey 


Jamaica 


UCT 


Japan 


US/ 


Libya 


UTC 


MET 


universal 


MST 


w-su 


MST7MDT 


WET 


Mexico/ 


Zulu 



( V indicates time zone prefixes) 



Enter time zone (default ^ *uS/Mountain') : <Retu3ni> 

What is today's date (mm/dd/yyyy, default.^ 2/1/1994)? <Retum> 
What time is it {24-hour hh:mm, default = 16:55)? <Return> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



standalone 

0.0.0.0 

0x00000000 

none 

/var/crash/standaione 

us /Mountain 

2/1/1994 

16:55 



Are these correct ('yes' or ^no')? 
yes 

Setting netmask of eiO to 255.255.255.0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on standalone. 

New password: 

Retype new password! 

Continuing boot 

starting rpc and net services: portraap [, 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button. 

* * * NOTE * * * 

If automatic boot is enabled it is necessary to interrupt the reboot by typing ^C in 
the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 



icpiiiiii 



■ 



If the system booted successfully originally, you may instead log in as root: 

/"standalone login: root 
I Password: 

In either case, if a file exists that tells the system it has been configured, remove it: 



illlllllliillil^ 



i 



The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 



(# exit 


) 


Otherwise, use fastboot: 


(^# /etc/ fastboot 


) 



The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing on a Series S4000 



Loading the Ramdisk 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

Loading the Local Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



( ^ROM> setenv installed 



I 



The system will ask if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4.1C distribution tape into the tape drive and enter the install 
command. If there is more than one tape drive, the bootROM asks which tape drive 
to use. For example: 

/^ROM> install 
Which type of device do you wish to install from; 

1 ) Tape 

2 ) Network 
Enter device type: 1 
You have the following tape drives. Please choose one: 

1) At Target4; drive name: ARCHIVE VIPER 150 21247-005 

2) At Targets, drive name: EXABYTE EXB-8200 2 5 IK 

Enter device number: 1 

V 

The bootROM copies the ramdisk image into memory and boots it: 

^Boot: St. si {,4, 4) 

Entry: OxfdO 80000 

Size: 0xec000+0x53ab28+0x42ab8 
J 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

Loading the Ramdisk via a Local CD-ROM Drive 

Turn the system on. After the system passes the self-tests, the bootROM prompt is 
displayed. 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



iiilllllliiiil^ 



I 



The system will ask if you want to re-install if INSTALLED is not 0, 

Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 



(ROH> boot sd.si(,6,)/lnstall. 34000 



I 



The bootROM copies the ramdisk image into memory and boots it: 

(^Boot: sd.sK, 6, ) /Install. S4000 

Entry: OxfdOSOOOO 
^Size; 00xea000H-0x43b8b8+0x309a8 ^ 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Diskful Installation 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 

ri) 610 

2) ansi 

3) hp 

4 ) sun 

5) tvi912 

6) vtlOO 

7) wyseSO 
What type of terminal are you using (*1''..'7')? 

If you are using a frame-buffer as the console, select the 4, the sun terminal type. 

(what type of terminal are you using i^t\ , ^7 ' )7 4 J 
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If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



/^THIS SYSTEM IS ALREADY INSTALLED 



Do you want to re-install the system {'yes', ^no' , or '?' 
for help) ? J 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-install the mandatory system software, or 
no to continue the installation without re-installing it. 

The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 

Ramdisk 



1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System: 

Enter number of function to execute ( * 1 ' . . ' 5 S or ^ ? ' for 
help) : 

The provided functions are described below: 

Change Disk Partitioning - Allows changing sizes of disk partitions, and whether 
those partitions are for filesystem space, swap space, or unused space. 

* * * NOTE • * • 

If changes are going to be made to the disk partitions on which OS/MP 4.1C will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. Refer to the section, "Software 
Installation from the Ramdisk," for more information. 
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Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 
select 'Change Disk Partitioning' before attempting to 'Install 
Software'. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 

Help may be requested at any ramdisk prompt by entering a question mark by itself. 
Table 15 shows edit commands available when entering text in response to 
prompts: 



Table 15. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input line 


'^R 


redisplay input line 


AW 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return (^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 
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Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



^# '^Jstty sane* J 

# cd / 

# rm ""f /core 

# inst^sys 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been gathered. 

The system uses three informational menus to gather the necessary information: 

O Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

D Installation Media Identification - Determines the installation media from 
which to install (tape, CD-ROM, or network directory), and determines where 
that media is located. 

D Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always retums to the ramdisk menu. If changes are to be discarded, then all 
changes made since install Software was selected are forgotten. 

previous always retums to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. 
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Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification Menu, enter 'continue'. 

Changing an entry at the Standard Filesystem Definition 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 12 shown below, the notation "(required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 



1) 
2) 
3) 
4) 
5) 



sdO: 
sdl: 



Standard Filesystem Definition. 

root on sdOa (required) 
swap on sdOb (required) 
/usr on sdOg (required) 
/var on root partition 
/tmp on root partition 

Disk Partitions (sizes in MB) 
(a) (b) (c) (d) (e) (f) 
8.4 32.4 191.1 9.3 
8.4 32.7 190.9 9,6 



(g) 

141.1 
140.8 



(h) 



Enter number of filesystem to change {'1',.''5'), 'continues 'previous', 
" cancel ' , or ' ? ' for help : 



Figure 12. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number 4. 



Enter number of filesystem to change ( * 1' . . ' 5 ' ) , 'continue' , 
^previous', * cancel' or *?' for help: 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



Enter name of disk partition or host: path for /var 
me^ystem, -none-, "C, or-?- for help: BdOd 

The new arrangement is displayed as shown in Figure 13. 



standard Filesystem Definition. 

1} root on sdOa (required) 

2) swap on sdOb (required) 

3) /usr on sdOg (required) 

4) /var on sdOd 

5} /tttip on root partition 









Disk Partitions (sizes 


in MB) 








(a) 


(b) 


(c) (d) (e) 


if) 


(g) 


<h) 


sdO: 


8.4 


32.4 


191.1 9.3 





141.1 





sdl: 


8.4 


32.7 


190.9 B.e 





140.8 






Enter number of filesystem to change ('1'..'5'}/ 'continue', 'previous', 
^cancel', or '?' for. help; 



Figure 13. Modified Standard Filesystem Definition Menu 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Media Identification Menu: 

Enter number of filesystem to change ( ' 1 ' . . ' 5 ' ) , 'continue' , 
'previous', 'cancel', or '?' for help; continue 

Installation Media Identification Menu 

The Installation Media Identification Menu specifies the location of the media 
which will be used during the installation. 

On Series S4000 systems, the default values are determined by how the ramdisk 
was booted. 

Figure 14 shows the Installation Media Identification menu of a S4000 machine 
that was booted from a local tape device stl (SCSI address 5). 

Installation may take place from Tape or CD-ROM. Each of these installations are 
discussed below. 
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Installation Media Identification 



1) Installation inedia type « Tape 

2) Tape drive - /dev/nrstl 

3) Local Internet address = 0.0.0.0 ^required for remote tape) 

4) Network broadcast tnask - OxffffOOOO {required for remote tape) 

5) Tape host ^ localhost (127.0.0.1) 



Enter selection number 
help; 



(*1'..**5')/ * continue', 'previous', 'cancel', or ^?'for 



Figure 14. Installation Media Identification Menu - Local Tapehost 

Tape Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to ' local - 
host'. The Installation media type must also be set to 'Tape'. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 15 shows the Installation media type menu 
with the CD-ROM parameters set to install from CD-ROM. 

When the details of the media have been entered correctly, enter continue. You 
will be presented with the Package Selection Menu. If the operating system has al- 
ready been installed, you will be prompted to insert the optional software distribu- 
tion media. 

Package Selection Menu 

The Package Selection menu is used to install optional Solboume software distri- 
butions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
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Installation Media Identification 

1) Installation media type ~ CD-ROM 

2} CD drive = /dev/srO 

3} Local Internet address = 0.0.0.0 (required for remote tape) 

4} Network broadcast mask ~ OxffffOOOO {required for remote tape) 

5) CD host - localhost {127,0.0.1} 



Enter selection ntimber (^l'..**5M» ^continue', 'previous'/ 'cancel' j. or ^?'for 
help: 



Figure 15. Installation Media Identification Menu - Local CD-ROM 

related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4.1C distribution tape. The following display shown in Figure 16 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Ins tailed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 

^Enter number of package to examine [^1* . . ^1* ) , ^ cancel * , 
* installs or ^?' for help: 1 

Should, the Solboume OS/MP 4,1C Optional Software package 
be installed (^yesS ''no', '"C, or ''?' for help)? yes 
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Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1) Solbourne OS/MP 4.1C Optional Software 34832 n 



Enter number of package to examine {'l'..*l'), 'cancel', 'install', or '?' 
for help: 



Figure 16. Package Selection Menu 

The Should the Solbourne Optional Software package be in- 
stalled question refers to the package in general. The modules are individually 
selected for installation on the customization screen, and by default all are selected 
for installation. 

After replying yes, the customization menu will appear as shown in Figure 17. 

* * • NOTE * * * 

Figure 1 7 is only an example. The Free KB reported will vary depending on the 
type and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sun window. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 
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y^ 

Customization of Solbourixe OS/MP 


4.1C Optional 


Software 






Software Modules 




Module 


Size (KB) 


Install 


Directory 


Free (KB) 


1) DEBUGGING 


2888 


y 


/usr 


58695 


2) GAMES 


3136 


y 


/usr 


58695 


3) MANUAL 


6992 


y 


/usr 


58695 


■ 4) NETWORKING 


1096 


y 


/usr 


58695 


5} PLOT 


1784 


y 


/usr 


58695 


6} SECURITY 


320 


y 


/usr 


58695 


7) SV_PROG 


1848 


y 


/usr 


58695 


8) SV^USER 


3144 


y 


/usr 


58695 


9) SYSTEM_V 


3992 


y 


/usr 


58695 


10) TEXT 


, 728 


y 


/usr 


58695 


11} VERSATEC 


5960 


y 


/usr 


58695 


12) UUCP 


608 


y 


/usr 


58695 


13) RFS 


912 


y 


/usr 


58695 


14) SHLIB 


1376 


y 


/usr 


58695 


15) TLI 


48 


y 


/usr 


58695 



Enter nuiuber of module to modify { '1' . . '^15' ) / 'continue' , * abort' , or '?' for help: 



Figure 17. Package Selection Customization Menu 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SA^P database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 
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SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, i.e. vtroff(l) and vpIot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

to other UNIX systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• • • NOTE * • * 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter number of module to modify ('1'..'15'), ^continue', 
"' abort ' , or '^ ? ' for help : 11 

The VERSATEC menu entry is highlighted, and: 

Modifying the Versatec printer support module 

Should the VERSATEC module be installed Cyes', 'no', ^Q, 

or '?' for help)? no 

Figure 18 shows the updated display: 
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Customization of Solbourne OS/MP 4.1C Optional Software 



Software Modules 



Module 


Size (KB) 


Install 


Directory 


Free {KB) 


1) DEBUGGING 


2888 


y 


/usr 


646B5 


2) GAMES 


3136 


y 


/usr 


64655 


3) MANUAL 


6992 


y 


/usr 


64655 


4) NETWORKING 


1096 


y 


/usr 


64655 


5) PLOT 


1784 


y 


/usr 


64655 


6) SECURITY 


320 


y 


/usr 


64655 


7) SV_PROG 


1848 


y 


/usr 


64655 


8) SV^USER 


3144 


y 


/usr 


64655 


9) SYSTEH^V 


3992 


y 


/usr 


64655 


10) TEXT 


728 


y 


/usr 


64655 


11) VBRSATEC 


5960 


n 






12) UUCP 


608 


y 


/usr 


64655 


13) RFS 


912 


y 


/usr 


64655 


14) SHLXB 


1376 


y 


/usr 


64655 


15) TLI 


48 


y 


/usr 


64655 



Enter number of module to modify i^l' 
help: 



'15'), ^continue', 'abort', or ^?' for 



Figure 18. Package Selection Menu - Deletion of Versatec Module 

• * * NOTE • • * 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 18. 

To install the GAMES module in /fun (on the root partition): 



Enter number of module to modify ( '1' . . '13' ) f 'continue' ^ 
'abort', or '?' for help: 2 



The G/\MES menu entry is highlighted, and: 



^Modifying the games and demonstration programs module ^ 

Should the GAMES module be installed ('yes', ^no', '^C, or 
"?' for help) ? yes 

Install GAMES in what directory? /fun 

/fun does not exist. Create it during installation ('yes', 
^noS '^C, or ^?' for help)? yes 

The menu is updated to reflect the change, as shown in Figure 19. 

* * * NOTE • * * 

The free space for /usr changes, and a completely new size (for/fiun) is also dis- 
played as shown in Figure 19. 
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Customization of Solboume OS/MP 4,1C Optional Software 



Module 


Size (KB) 


1) 


DEBUGGING 


2888 


2) 


GAMES 


3136 


3) 


MANUAL 


6992 


4) 


NETWORKING 


1096 


5) 


PLOT 


1784 


6) 


SECURITY 


320 


7) 


SV_PROG 


1848 


8) 


SV_USER 


3144 


9) 


SYSTEMJ/ 


3992 


10) 


TEXT 


728 


11) 


VERSATEC 


5960 


12) 


UUCP 


608 


13) 


RFS 


912 


14) 


SHLIB 


1376 


15) 


TLI 


48 



Software Modules 




Install 


Directory 


Free {KB) 


y 


/usr 


67791 


y 


/fun 


4579 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


n 






y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 



Enter nioinber of module to modify {*1'..'15'), 'continue'/ 'abort', or '?' for 
help: 



Figure 19. Package Selection Menu - Install Games module to /fun 

If you decide to discard all changes made to the modules, use the command 
'abort'. This returns to the Package Selection menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand 'continue'. This will record the changes and return to the Package Selec- 
tion menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter 'install' as shown in Figure 20. 

The actual installation begins at this point, and may require 10 minutes to one hour. 

The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping.) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 21). If 
the installation failed, call Customer Support. 
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Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1} solbourne OS/HP 4.ac Optional Software 34832 y 



Enter number of package to examine {'1' . .'1') , 'cancel', 'install', or '?' 
for help: install 



Figure 20. Package Selection Menu 



Ramdisk 



1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Enter number of function to execute (*!'..* 5", or *?' for help): 4 



Figure 21. Ramdisk Menu 
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Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as show in Figure 22. 



Reboot System 



1) Boot Unix 

2) Boot on ramdisk 

3) Return to Main Menu 



Enter selection number ('1'..'3') or '?' for help: 1 



Figure 22. Reboot System Menu 

Enter number of function to execute ('r..'5', or '?' for help): 4 
At the Reboot System menu select Boot Unix: 



(^ Enter selection number { ' 1 ' . . ' 3 ' ) or ' ? ' for help : 1 } 
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After selecting 1, there is a short pause, and then: 

/^Automatic boot enabled. Type Control -C to abort 
ROM> boot 
Boot: sd.si (0^ 0^ 0) /vmunix 

Entry: 0xff060000 

Size: 0xd6000+0x33358+0x81548 



OS/MP 4»lC„Export (GENERIC/ root) #0: Tue Feb 1 15:52:44 
1994 ■ 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

liiA , J 

At this point, the system configuration information must be specified. 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4,lC_Export (GENERIC /root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems/ Inc. and '- 
Solbourne Computer, Inc» 
[ . . . ] 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas: done. 

This system has not yet been configured.' Several values 
need to be set before the system can come up to multi-user 
Unix. - ' , - 

What is this system's name (default ~ * standalone' ) : 
<RettLm> 

What is its Internet address (0 for none, default - 
255.255.255.255)? <R0tttm> 

What directory should be used for automatic savecore files 
(^none' for none, default - */var/crash/standalone' ) ? 
<Ret'am> 



* • • NOTE • * • 
Using the value '0' for the IP address disables the NIS/YP services. 
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Time zone 


choices aret 








Australia/ 


GMT+11 


GMT- 3 


GMT 6 


Mideast/ 


Brazil/ 


GMT+1 2 


GMT-4 


GMT7 


NZ 


GET 


GMT+1 3 


GMT- 5 


GMT 8 


Nava j o 


CST6CDT 


GMT+2 


GMT- 6 


GMT 9 


PRC 


Canada/ 


GMT+3 


GMT- 7 


Greenwich 


PST8PDT 


Chile/ 


GMT+4 


GMT -8 


HST 


Poland 


Cuba 


GMT+5 


GMT- 9 


Hongkong 


ROC 


EET 


GMT+6 


GMTO 


Iceland 


ROK 


EST 


GMT+7 


GMTl 


Iran 


Singapore 


EST5EDT 


GMT+8 


GMTIO 


Israel 


Turkey 


Egypt 


GMT+9 


GMTll 


Jamaica 


UCT 


Factory 


GMT-0 


GMT 12 


Japan 


US/ 


GB-Eire 


GMT~1 


GMTl 3 


Libya 


UTC 


GMT 


GMT- 10 


GMT2 


MET 


Universal 


GMT+0 


GMT- 11 


GMT3 


MST 


W-SU 


GMT+1 


GMT- 12 


GMT4 


MST7MDT 


WET 


GMT+10 


GMT- 2 


GMT5 


Mexico/ 


Zulu 



{ V indicates time zone prefixes) 



Enter time zone (default - ' US /Mountain M i <Return> 

What is today's date <mm/dd/yyyy,. default = 2/1/1994)? <Retum>- 
What time is it {24-hour hh:mm, default « 16:55)? <Return> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



standalone 

0.0.0.0 

0x00000000 

Rodent . COM 

/var/crash/standalone 

US /Mountain 

2/1/1994 

16:55 



Are these correct (*yes' or 'no')? 
yes 

Setting netmask of eiO to 255.255,255,0 

Teus Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on habi trail. 

New password: 

Retype new password: 

Continuing boot 

starting rpc and net services: portmap [...] 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on. 

• * * NOTE • * • 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 




If the system booted successfully originally, you may instead log in as root: 



habi trail login: root 
Password: 



In either case, if a file exists that tells the system it has been configured, remove it: 



The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 



(# ^xit ■ 


: } 


Otherwise, use fastboot: 


( # /efcc/f astboot 


) 



The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing OS/MP 4.1C on a 
Standalone using reinst_sys 



This chapter describes how to install OS/MP 4.1C on a server using the utility, 
reinst_sys, which allows you to upgrade your system with a full installation of the 
operating system on unused partitions of one or more disks, while remaining in 
multi-user mode. 

A standalone system does not provide NFS disk services to clients. It also does not 
depend on a server for its root, swap, or /usr filesy stems. 

The purpose of reinst_sys is to minimize downtime by performing a full install of 
OS/MP onto a new system disk while the system continues to run an earlier version 
on an old system disk. Once reinst_sys is complete, you are free to do whatever 
local modifications are desirable before booting from the new disk. 

For example, you might reconfigure the OS/MP 4. IC kernel or modify files of local 
interest such as /etc/printcap. Only when the new system disk is ready to run do 
you need to halt the old system and reboot from the new disk. 

Finally, unlike earlier full install releases, reinst_sys makes it possible to fall back 
to the earlier version of OS/MP if there turns out to be some problem with the way 
you set up the new system. To fall back to the old system, halt the new system, 
change ROM variables DEFAULTROOT and perhaps DEFAULTSWAP, and 
then boot. 

* * * NOTE * iV * 

In order to use this utility, you must have an unused disk, or at least enough unused 
partitions, on which to install the OS/MP 4.1 C release. You can not use reinst_sys 
to install over the currently running disk partitions. If you do not have an unused 
disk for reinst_sys to use, you will have to install OS/MP 4.1Cfrom scratch, while 
the system is unavailable to your users, as was done in previous OS/MP full instal- 
lation releases. 

You should not install on a disk connected to a channel board as it will be impos- 
sible to boot from that device. 
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Before Installing*.. 



* * * NOTE * * • 

Before using reinst_sys, you must know what disk(s) and partitions you want to in- 
stall on. If changes need to be made to any of the disks partitions, you must do this 
prior to running reinstjsys. Use partition(8) to modify the disks. 

It is best to select a disk that will be recognized by an OS/MP 4.1C generic kernel. 
Otherwise it will be necessary to reconfigure the kernel (which may be desirable 
anyway) before rebooting. This is discussed in more detail at the end of this sec- 
tion. 

-ki^ic CAUTION * • * 

If installing by tape, clean the tape drive on the machine you will be using be- 
fore installing the release tape. Failure to do so may damage the release tape. 

Starting in OS/MP 4.1C, the preinstall utility is available to help determine which 
system files should be restored or merged from backup, preinstall shows which 
files in system directories were modified after you last installed the OS version 
you're currently running. 

If you do not want to use preinstall, skip to the Extracting reinst_sys section be- 
low. 



Installing preinstall.. 



Because preinstall was not included in versions of OS/MP prior to 4.1C, it is nec- 
essary to install it before proceeding to install OS/MP 4.1C. 

When using a local tape drive, install preinstall using the following commands: 

/^# mt -f /dev/nrsto asf 5 ~~ ^~~ ^ ~~ ~~~ " 

# cd /usr/etc 
v ^# tar aepf /dev/nrstO 

When using a local CD-ROM drive, install preinstall using the following com- 
mands: 



f% xokdir /cdrom 

# mount /d€iv/srO /cdrom 

# cd /usr/etc 

# tar xpf /cdrom/Tools.tar 
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Using preinstall 

After preinstall has been installed, it is located in /usr/etc. The usage of preinstall 
is as follows: 



/usr/etc/preinstall [ -1 ] [ -c mmddhhmm[yy] ] 

The preinstall command is used to look for files that should be saved prior to doing 
a fiill install of a new version of OS/MP. It looks on the system partitions (root(/), 
/usr, and/var) for files which have been touched after the date of the last full install 
of OS/MP (or, if given a cutoff date, files touched after that date). 

preinstall is normally used just before installing a new version of OS/MP to deter- 
mine what system-related files should be backed up. Then, after installing the new 
version of OS/MP, you can merge or restore these files into the newly-installed sys- 
tem. 

Some files, such as /etc/fstab, can typically be re-used without modification. Oth- 
ers, such as kernel configuration files in /usr/kvni/sys/*/conf, must be hand- 
merged into the new version of the OS with careful consideration of how the new 
OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. 
These files are normally updated by system operation and do not need to be backed 
up. Examples of excluded files are: /etc/mtab, the/var/sadm accounting files, the 
/tmp_mnt automounter directories, and patched kernel object files in 
/usr/kvm/sys/*/OBJ. By default, the cutoff date used is the modification date of 
the file /etc/sys_con^systeni-configured, which is touched the first time you boot 
a new version of the OS after a full install. You may want to use some other cutoff 
date with the -c option if the current OS was installed in some non-standard way. 

By default, the files and directories newer than the cutoff are listed to standard out- 
put by name, one per line. By using the -1 option, the output is in long form (as from 
the -Is option to find), showing the type, date, and size of each file. 

The following options are accepted by preinstall: 

□ The -1 option presents the output in long form, showing inode number, size in 
kilobytes (1024 bytes), protection mode, number of hard links, user, group, 
size in bytes, and modification time. If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic 
link the pathname of the linked-to file is printed preceded by '- >'. The format 
is identical to that of find -Is. 

□ The -c option specifies to use the given cutoff date to decide which files to 
print, rather than the date of the file /etc/sys_con^system-configured. The 
cutoff date format is -c mmddhhmm[yy], with month, day, hour, minute, and 
optional year in numeric form. This is the same format as for/usr/5bin/touch. 
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Extracting reinst_sys 



Extracting reinst_sys via a 
Local Tape Drive 



reinst_sys has been modified since OS/MP 4. IB, so be sure to extract the new ver- 
sion from the OS/MP 4.1C media. If you installed preinstall as shown above, then 
the server already contains the version of reinst_sys that it needs and you may skip 
to the Installing section below. 

The following explains two different methods of extracting reinst_sys into the /us- 
r/etc directory. You must be logged in as root. 



j^# mt -f /dev/nrstO asf S 


'^^^^^U^u^ 


# cd /usr/etc 


llllliiiiiiiiiiiiiii 


I # tar Kpf /dev/nrstO 


J 



Extracting reinst_sys via a 
Local CD-ROM Drive 



Create a mount point directory (if one doesn't exist), mount the CD-ROM drive, 
and extract reinst_sys as follows: 



r# mkdir /cdrom "^ 

# mount /dev/srO /cdrom 

# cd /usr/etc 

l ^# tar xp£ /cdrom/Tools«tar 
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Installing, 



This section covers the OS/MP 4.1C installation on Series5, SeriesSE, Series6 and 
S4000 systems. 

During installation, you can request help at any prompt by entering a question 
mark. Table 16 shows edit commands available when entering text in response to 
prompts: 

Table 16. Input Editing Commands 



Character 


Interpretation 


backspace (^H) 


delete last input character 


delete (^1) 


delete last input character 


^U 


erase input line 


'^R 


redisplay input line 


A^ 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


^L 


redisplay entire screen 


return (^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



^# ^Jstty sane^J 


IIIH^^^^^^^^ 


liiliii 


■iii 


# rm -f core 


lllll 


iliilii 


III 


# /usr/©tc/reinst_sys 


JB^^^^^^^^^^^^^ 


llllll 


iiir 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 
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Installing Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 

There are three information gathering menus: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

□ Installation Media Identification - Determines the installation media from 
which to install (tape, CD-ROM, or network directory), and determines where 
that media is located. 

□ Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the shell terminating reinst_sys. 

previous always returns to the previous menu (which is the shell, in the case of the 
Filesystem Definition menu). The changes discarded in this case are those made in 
the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to the standard filesystems with partition(8) will appear in this 
menu. 

reinst_sys has the following options: 

reins t_sys [-m] [-n] [-r /root/path] [-f host:/device/path] [-a arch] 

-m Don't mount or newfs filesystems 

-n Don't newfs filesystems 

-r /root/path Pretend /root/path is really / 

-f host:/device/path What tape device to use 

-a arch What cpu architecture to use - overrides cpustatus 
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In general, you will not need to use any of these options except perhaps the -a op- 
tion. The -f option will be set while running reinst_sys. 



The -a option is to be used when you are upgrading or changing the architecture of 
your machine. Suppose you have a machine with Series5 CPUs, and you want to 
upgrade to Series6 CPUs. To install the OS/MP 4.1C for Series6, log in as root and 
issue the following command: 

|[iiiliii|iipiiiliiilii^ 

To install OS/MP 4.1C with no change in architecture, log in as root and issue the 
command: 



Q# /iii|iiij|jMiiii:iiip 



reinst_sys begins by reading the current /etc/fstab file to determine the disks at- 
tached to your system (mounted disks are also probed). 

After examining all attached disks, reinst_sys presents the first menu, the Standard 
Filesystem Definition menu. 

The root, swap, and usr partitions are required and must be defined before going to 
the next menu. The swap will be defined as the current swap area, and may be re- 
defined if you wish. The root and usr areas need to be defined from the currently 
available disk partitions that are highlighted in the Standard Filesystem Definition 
menu. For a disk partition to be available for use in reinst_sys, it must not be cur- 
rently mounted, and it must not have an entry in the /etc/fstab file. 

Example: 

Currently, the root(/) filesystem is on sdOa, swap is on sdOb, and the /usr filesys- 
tem is on sdOg. Available partitions are highlighted. If the necessary partitions are 
not available, exit reinst_sys. A partition may not be available because it is mount- 
ed or an entry exists for it in the /etc/fstab file. Also, it may not be available be- 
cause it does not exist, or it is not large enough, in which case you will need to run 
partition(8) to repartition the disk as needed. 

Use the following steps to assign the root (/) filesystem to sd2a, the /usr filesystem 
to sd2g, and the /var filesystem to sd2d (rather than using the default of /var being 
a subdirectory of the root filesystem). Leaving swap on the disk may be desirable. 

The steps for changing /var are optional. This makes use of partition d, thus using 
9.5 MB of disk space that is not used when the default disk partition is used with 
the standard filesystem definition. 

In Figure 23, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any sufficiently large available partition of any disk. 
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Standard; Filesystem Definition 



1) root (required): 

2) Swap on sdOb (retjuired) 

3) /usr (required) 

4) /var on root partition 

5) /tmp on root partition 



<not defined> 
<not defined> 



sdO 
sd2 



Disk Partitions (sizes in MB) (available highlighted) 
(a) (b) (c) (d) (e) (f) (g) (h) 

8.4 32.4 191.1 9.3 -~- -~- 141,1 

8.5 32.9 484.9 9.5 — - — 433.5 



Enter number of filesystem to change ('1'..'5')/ ^continue', "previous'/ 
'cancel', or '?' for help: 



Figure 23. Sample Standard Filesystem Definition Menu 
To modify the root (/) filesystem, enter the number 1 . 



Enter number of filesystem to change (^l'.-^5')/ 
^continue', ^previous', ^cancel' or ^?' for help: 1 



The root menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2a. 



/^Enter name of disk partition or hosttpath for /root 
(filesystem, ^none' , -^C, or'?' for help: sd2a 

To modify the /usr filesystem, enter the number 3. 

I^Enter number of filesystem to change {*!'.. '5' ) , 
[ ^continue', "previous', "cancel' or "?' for help: 3 



The usr menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2g. 



Enter name of disk partition or hosttpath for /usr 
filesystem, "none', '^C, or"?' for help: sd,2g 



To modify the /var filesystem, enter the number 4. 



Enter number of filesystem to change (*1^..^5'')/ 
continue'/ "previous', "cancel' or *?' for help: 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2d. 

Enter name of disk partition or host:path for /var 
filesystem^ *noneS ^C, or^?' for help: sd2d 



The new arrangement is displayed as shown in Figure 24. 



Standard Filesystem Definition 

1) root on sd2a t required) 

2) swap on sdOb (required) 

3) /usr on sd2g (required) 

4) /var on sd2d 

5} /tmp on root partition 

Disk Partitions (sizes in MB) (available highlighted) 
(a) (b) (c) (d) (e) (f) (g) (h) 
sdO: 8.4 32.4 191.1 9.3 — — 141.1 

sd2: 8.6 32.9 484.9 9.9 — — 433.5 



Enter nuinber of filesystem to change {'!'.. '5')/ ' continue S 'previous', 
''cancel'/ or '?' for help: 



Figure 24. Modified Standard Filesystem Definition Menu 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Installation Media Identification menu. 

Enter number of filesystem to change (^1^».*5')/ 
'continue', 'previous''^ ^cancel', or *?' for help: continue 

Installation Media Identification Menu 

The Installation Media Identification menu describes which media type (tape, CD- 
ROM, or network directory) will be used during the installation. Figure 25 shows 
the Installation Media Identification menu. 

Installing from a Local Tape Drive 

Installing from a local tape drive requires that the Installation media type be set to 
Tape, the ?a/7e Jnve field be set to either stO or stl (the only supported tape 
drives) and that Tape host be set to localhost. 
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- Installation, Media" Idesntification 



Ta£>« 



,1)- Xnstallation, jfiedla type ,« 
2) Tape, drive,,, ^ /deV/nrstO 
•2>y- Xiocal ' Internet address « , 1 9 2 , 9 , 3 . 4 . ( required for remote - tape ) 

4) network broadcast' mask. « Ox£f£f£f 00- (required for remote tape) 

5) ^ Tape hb$t ^i».-localhoet {127^0. 0»i) : 



'Entef.jseiection niJrober i^l' 



5^) , ^continue'/ ' previous '^ 'cancel', or *?'for 



Figure 25. Installation Media Identification Menu - Local Tapehost 

Local CD-ROM Installation 

Installing from a local CD-ROM drive requires that the Installation media type be 
set to CD-ROM, the CD drive field be set to /dev/srO, and the CD host field be 
set to localhost. 

Figure 26 shows the Installation Media Menu with the CD-ROM parameters set to 
install from CD-ROM. 

Once the details of the media have been entered correctly, enter continue to pro- 
ceed to the Package Selection Menu. 

Package Selection Menu 

Use this menu to install optional Solboume software distributions. It provides a 
menu-driven method of examining the components of the distribution tape, select- 
ing the parts to be installed, and specifying the directories where the components 
will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solboume OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 
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Installation Media Identification 

1)- Installation media type » CD-ROM 

2) CD drive ^ /dev/srO 

3) Local Internet address = 0,0.0.0 {required for remote install) 

4) Network broadcast mask ~ 0x00000000 {required for remote install) 

5) CD host = localhost {127.0.0.1) 



Enter selection niamber ('1' . . ""SM » 'continue', 'previous 'j, 'cancel', or '?''for 
help : 



Figure 26. Installation Media Identification Menu - Local CD-ROM 

A single package, OS/MP 4.1C Full-Install Optional Software, is included on the 
OS/MP 4.1C distribution tape. The following display shown in Figure 27 appears; 
the values shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Ins tailed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 

(^ Enter number of package to examine { ' 1 ' , . ' 1 ' ) , ' cancel ' / 
'install', or '?' for help: 1 

Should the OS/MP 4.1C Full-Install Optional Software 
i^package be installed {'yesS "noS ^C, or '?' for help)? 

The Should the OS/MP 4 . IC Full-Install Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 



After replying yes, the customization menu will appear as shown in Figure 28. 
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Package Selection 
Mandatory Software Will Be Installed 
Package Name Size {KB) Install 

1) OS/HP 4.1C Full-Install Optional Software 34832 n 



Enter number of package to examine {'l'..^l')/ ^cancel', * install', or *?' 
for help: 



Figure 27. Package Selection Menu 

* • • NOTE * • * 

Figure 28 is only an example. The free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule' s name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING ■ program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sun window. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 
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Customization of Solbourne OS/MP 4.XC Optional Software 



Module 


Size (KB) 


1) 


DEBUGGING 


2888 


2) 


GhMES 


3136 


3) 


MANUAL 


7440 


4) 


NETWORKING 


1072 


5} 


PLOT 


1784 


6) 


SECURITY 


312 


7) 


SV_PROG 


1848 


8) 


SV_USBR 


2320 


9) 


SYSTEH^V 


4032 


10) 


TEXT 


720 


11) 


VBRSATEC 


5960 


12) 


UUCP 


608 


13) 


RFS 


912 


14) 


SHLIB 


1376 


15) 


TLI 


48 



Software Modules 
Install Directory 



/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 
/usr 



Free {KB) 
58695 
58695 
58695 
B8695 
58695 
58695 
58695 
58695 
58695 
5869S 
58595 
58695 
58695 
58695 
58695 



Enter ninnber of module to modify pl',.*15*)/ * continue', ^aborts or ^?' for 
help: 



Figure 28. Package Selection Customization Menu 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SA^P database services, 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling Sun View applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 
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SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

* * * NOTE * • • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter number of module to modify (*!'.. '15'), 'continue', 
'aborts o^r ^?^ for help; 11 

The VERSATEC menu entry is highlighted, and: 

^Modifying the Versatec printer support module 

Should the VERSATEC module be installed CyesS 'no', '^C, 
^or '?' for help)? no ^ 

Figure 29 shows the updated display: 

• * • NOTE * * • 

The free space for Aisr has been increased by the size of the VERSATEC module 
as shown in Figure 29. 
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Customization of Solfoourne OS/MP 4.1C Optional Software 



Software Modules 



Module 


Size (KB) 


Install 


Directory 


Free {KB) 


1) DEBUGGING 


2888 


y 


/usr 


646S5 


2) GiUffiS 


3136 


y 


/usr 


64655 


3) MANUAL 


7440 


y 


/usr 


64655 


4) NETWORKING 


1072 


y 


/usr 


64655 


5} PLOT 


1784 


y 


/usr 


64655 


5) SECURITY 


312 


y 


/usr 


64655 


7 ) SV_PROG 


1848 


y 


/usr 


64655 


8) SV_USER 


2320 


y 


/usr 


64655 


9) SYSTEM^V 


4032 


y 


/usr 


64655 


10) TEXT 


720 


y 


/usr 


64655 


11) VERSATEC 


5960 


n 






12) UUCP 


508 


y 


/usr 


64655 


13) RFS 


912 


y 


/usr 


64655 


14) SHLIB 


1376 


y 


/usr 


64655 


15) TLI 


48 


y 


/usr 


64655 



Enter number of module to modify {'!',. '15')/ ^continue', * abort ', or ^?' for 
help: 



Figure 29. Package Selection Menu - Deletion of Versatec Module 
To install the GAMES module in /fun (on the root partition): 



Enter number of module to modify { ^1' * . '13 ' ) ; ''continue' , 
'abort'; or '?^' for help: 2 



The GAMES menu entry is highlighted, and: 



(^Modifying the games and demonstration programs module ^ 

Should the GAMES module be installed ('yes', 'no', -^C, or 
' ? ' for help) ?. yes 

Install GAMES in what directory? /ftin 

/fun does not exist. Create it during installation {'yes', 
'no', '^C, or '?' for help)? yee , 

The menu is updated to reflect the change, as shown in Figure 30. 

• • • NOTE • • • 

The free space for Aisr changes, and a completely new size (for /fun) is also dis- 
played as shown in Figure 30. 

If you decide to discard all changes made to the modules, use the command 
abort. This retums to the Package Selection Menu. 
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Customization of Solbourne OS/MP 4.1C Optional Software 



Software Modules 



Module 


Size (KB) 


Install 


Directory 


Free {KB) 


1) DEBUGGING 


2888 


y 


/usr 


67791 


2) GAMES 


3136 


y 


/fun 


4579 


3) MANUAL 


7440 


y 


/usr 


67791 


4) NETWORKING 


1072 


y 


/usr 


67791 


. 5) PLOT 


1784 


y 


/usr 


67791 


5) SECURITY 


312 


y 


/usr 


67791 


7) SV_PROG 


1848 


y 


/usr 


67791 


8) SV^USER 


2320 


y 


/usr ■ 


67791 


9) SYSTEM„V 


4032 


y 


/usr 


67791 


10} TEXT 


720 


y 


/usr 


67791 


11) VERSATEC 


5960 


n 






12) UUCP 


608 


y 


/usr 


67791 


13) RFS 


912 


y 


/usr 


67791 


14) SHLIB 


1376 


y 


/usr 


67791 


15) TLI 


48 


y 


/usr 


67791 



Enter number of module to modify {'1'..'15'), ^continue', 'abort', or '? 
help: 



for 



Figure 30. Package Selection Menu - Install Games module to /fun 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 31. 

The actual installation begins at this point. The steps taken during the installation 
are: 

1 . create filesystems (root(/), /usr, possibly /var or /tmp 

2. install mandatory root files 

3. install mandatory kvm files 

4. install mandatory usr files 

5. install optional software 

When installation has finished, it gives the following message: 

/^Optional Software Installation Succeeded. 
Press any character to continue 
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Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1} OS /HP 4.1C Full- Ins tall Optional Software 34832 y 



Enter number of package to examine ('l'..^l')/ ^cancel', 'install', or '?' 
for help: instalX 



Figure 31. Package Selection Menu 

The next display gives the values of the previous and new ROM variables DE- 
FAULTROOT, DEFAULTSWAP (if they have changed), and asks if you want to 
update the variables, as shown in Figure 32. 

* * • NOTE • • * 

Before you say 'yes ', make sure that all the previous settings of these variables are 
recorded so that you can later reboot from the old version of the system if neces- 
sary. If you choose not to update the ROM variables, make sure that you record the 
new values and use them to reboot the newly installed system at a later time. 

reinst_sys then performs the final system setup, and completes. The new system's 
filesystems are currently mounted under the /etc/sys_conf/reinst_sys/root directo- 
ry. For example, the new version of the /var directory is mounted at /etc/sys_con- 
f/reinst_sys/root/var. 

At this point, the newly installed system is ready to boot. However, you may want 
to finish the installation by creating or editing such files as /etc/rclocal and 
/etc/printcap, or any other files local to your system. If you have comments in your 
/etc/fstab file, they will not exist in the new /etc/fstab file, so you may want to edit 
this file. 

* • * NOTE * • • 

If you installed the new system on a disk that is not recognized by a OS/MP 4.1 C 
generic kernel, then you must reconfigure the kernel before rebooting. 
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Ready to Update ROM Variable 

Previous DEFAULTROOT~sd . s i { , Q , ) , New DEFAULTROOT=sd .si{0,2,0) 

Do you want to go ahead and update the ROM {'yes', 'no', '^C, or '?' for help)? 



Figure 32. Update ROM Variable 

You may also wish to create a customized kernel on the new system, so that hard- 
ware such as the channel board and VSCSI devices will be recognized. If you 
would rather wait until after rebooting the new system to configure your kemel, 
you should edit the new /etc/fstab file and comment out any partitions which are 
on disks not visible to the generic OS/MP 4.1C kemel. 

After you have completed customizing the new installation, reboot your machine, 
using the new ROM variables. 

If you used the -a option to upgrade to a different architecture, then after custom- 
izing the new installation, halt the machine and turn off the power. Replace the old 
CPUs with the new CPUs, power up and boot your machine using the new ROM 
variables. 
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Before Installing... 



Installing OS/MP 4.1C on a Server 



This chapter describes how to install OS/MP 4. IC on a server. A server is a system 
that is on a network and may provide NFS disk services. 



* * • CAUTION * • • 

Perform a full system backup before installing OS/MP 4.1C. A complete in- 
stallation overwrites all information on the disk partitions specified for the 
root (/), swap, /usr, /var, and /tmp fllesystems. 

Before installing the release tape, clean the tape drive on the host machine. 
Failure to do so may result in damage to the release tape. 

Starting in OS/MP 4.1C, the preinstall utility is available to help determine which 
system files should be restored or merged from backup, preinstall shows which 
files in system directories were modified after you last installed the OS version 
you' re currently running. 

If you do not want to use preinstall, skip to the section Modifying the Hosts Data- 
base below. 

If you are going to be installing from a remote device, make sure you obtain the 
following information: 

D Host name of system being installed 

□ IP address of system being installed 

D Ethernet address of system being installed 

□ Tape host name and IP address 



Installing preinstall. 



Because preinstall was not included in versions of OS/MP prior to 4.1C, it is nec- 
essary to install it before proceeding to install OS/MP 4.1C. 
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When using a local tape drive, install preinstall using the following commands: 



iiliiiilliillliiH 



When using a remote tape drive, the system name needs to be in the tapehos ts 
/.rhosts file. Install preinstall using the following commands: 



iillilllllliiilliii 


::iii:ll:ii:;li:;ii|:ill::-:ilii;^i:| 


liiiiiiliiiiiiiH^^^^^^^^ 


||i|||iii|||||iB 


|j;|ii|lila^^^^^^^^ 


lliiilllillli;;liliH^^^^ 



In this example, you should replace tapehos t with the actual name of your tape 
host machine. 

* * * NOTE • • * 

Some older versions of SunOS do not support the 'asf request for mt. If this is the 
case for your tape host, first substitute 'rew'for 'asf 5' in the above example, and 
then re-execute mt with fsfS' instead of 'rew'. 

When using a local CD-ROM drive, install preinstall using the following com- 
mands: 

lljlllllllijlii^lli^^^^ 
jiiiliiij|illijiiiB 

When installing over the network, or when using a remote CD-ROM drive, create 
a mount point directory (if one doesn't exist), and mount the CD-ROM drive on the 
remote machine, referred to here as net hosts, as follows: 

l^nethostt mkdi'r /cdrom <■ 

V ^nethostt motant Mev/srO /cdrom ._________________.__._.^^ 

Install preinstall using the following commands: 

/^# cd /usr/etc "~" — v^ 

V# rsli "-n nethost dd if^/cdroin/Tools.tar bsaiSk | tar atpBf -J 

In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 
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Using preinstall 

After preinstall has been installed, it is located in /usr/etc/setup. The usage of pre- 
install is as follows: 

/usr/etc/setup/preinstall [ -1 ] [ -c mmddhhmm[yy] ] 

The preinstall command is used to look for files that should be saved prior to doing 
a full install of a new version of OS/MP. It looks on the system partitions (root(/), 
/usr, and /var) for files which have been touched after the date of the last full install 
of OS/MP (or, if given a cutoff date, files touched after that date). 

preinstall is normally used just before installing a new version of OS/MP to deter- 
mine what system-related files should be backed up. Then, after installing the new 
version of OS/MP, you can merge or restore these files into the newly-installed sys- 
tem. 

Some files, such as /etc/fstab, can typically be re-used without modification. Oth- 
ers, such as kernel configuration files in /usr/kvm/sys/*/conf, must be hand- 
merged into the new version of the OS with careful consideration of how the new 
OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. 
These files are normally updated by system operation and do not need to be backed 
up. Examples of excluded files are: /etc/mtab, the /var/sadm accounting files, the 
/tmp_mnt automounter directories, and patched kernel object files in 
/usr/kvm/sys/*/OBJ. By default, the cutoff date used is the modification date of 
the file /etc/sys_con^system-configured, which is touched the first time you boot 
a new version of the OS after a full install. You may want to use some other cutoff 
date with the -c option if the current OS was installed in some non-standard way. 

By default, the files and directories newer than the cutoff are listed to standard out- 
put by name, one per line. By using the -1 option, the output is in long form (as from 
the -Is option to find), showing the type, date, and size of each file. 

The following options are accepted by preinstall: 

D The -1 option presents the output in long form, showing inode number, size in 
kilobytes (1024 bytes), protection mode, number of hard links, user, group, 
size in bytes, and modification time. If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic 
link the pathname of the linked-to file is printed preceded by '- >' . The format 
is identical to that of find -Is. 

□ The -c option specifies to use the given cutoff date to decide which files to 
print, rather than the date of the file /etc/sys_conf/system-configured. The 
cutoff date format is -c mmddhhmm[yy], with month, day, hour, minute, and 
optional year in numeric form. This is the same format as for /usr/5bin/touch. 
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Modifying the Hosts 
Database... 



Any host on a network must be added to the hosts database. Before you can add a 
host to either database, choose a name and an address for that host. Be sure both 
are unique for your network. Determine which one of the three network informa- 
tion databases you are using. 

O Static files - this is the simplest form of the databases: two files, /etc/hosts and 
/etc/ethers. 

O Network Information Service - NIS, formerly called Yellow Pages (YP), is a 
centralized version of the static files approach. Fundamentally, one system, the 
NISAfP master, uses the static files. Other systems ask the master to look up 
entries in its files. 

D Domain Name Service - DNS is part of the software used to administrate the 
Internet, and is beyond the scope of this document. If you are using it, contact 
your system administrator for information on updating entries in it. 

If you are using NIS/YP, take the following actions on the NISA?"? master. If you 
are using static files, take the following actions on the system that is to act as a serv- 
er (by providing either its tape or disk drive). Only the superuser (account name 
root) is allowed to update these files. 

□ Update the hosts database with the name and IP address chosen for any new 
client by adding a line of the following form to /etc/hosts: 



I 



iiiliilliiiiillili 



I 



If you are instalhng a diskless client on your server, update the ethers database 
by adding a line of the form below to /etc/ethers. The six colon-separated 
numbers are the ones displayed by the system when the power is turned on. The 
name must be the same as was added to the hosts database. 



(^0t0;$ea0t0a6 hamster 



□ If you are using NIS/YP, the working copy of the database must be updated: 

/^# cd /var/yp 
[ # xnake 



J 



* * * NOTE * * • 
Execute make on the NIS/YP master server only. 
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Installing... 



Installing on a Series5, 
Series5E or Series6: 



This section covers the OS/MP 4.1C installation on Series5, SeriesSE, Series6 and 
S4000 systems. 



Loading the Ramdisk 

The following explains four different methods of loading the ramdisk. After you 
have loaded the ramdisk continue on to the Dishful Installation section. 

Loading the Ramdisk via a Local Tape Drive 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



|i|ii|[i|||i||||p^ 



• 



The system asks if you want to re-install if INSTALLED is not 0. 

To load the ramdisk on Series5 or 5E systems using a local tape drive, enter a boot 
command in the following form: 



tiiiMllBliaiilBliiiiiilil 



I 



To load the ramdisk on Series6 systems using a local tape drive, enter a boot com- 
mand in the following form: 



('rom> boot st.si (^ Tape JD, 3) 



J 



The variable Tape JD shown in the command should be replaced with the SCSI ID 
of the tape drive to be used. For stO, use 4; for stl, use 5. 

The bootROM copies the ramdisk image into memory and boots it: 



fBootx st.si(,4,3) 
Entry: 0xffO60O00 
Size: Oxl0e000+0x56afb8+0xadc40 



The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. Proceed to the Dishful 
Installation section 



1 32 Installing OS/MP 4. 1 C on a Server 



Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following exani- 
ple, must be on the same network as the system being installed, referred to as ham- 
ster in the following example. For example, with a class C network, the first three 
numbers in the Internet addresses of the two machines must be the same, such as 
192.1.3.42 and 192.1 .3.17. Also, hamster must be listed in /etc/hosts, or in the NI- 
SA^P hosts database, and/.rhosts on tapehost. In addition, the ethemet address 
must be in the ethers database. The tapehos t must also be running the rarpd(8) 
daemon.The ramdisk must be extracted from the OS/MP 4.1C distribution tape 
onto a disk on tapehost. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf, A line similar to the one below should 
be in the file: 

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -& 
/tftpboot 

If the line starts with a #, remove the #. 

If a - s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 



f tapehost # pB Bx \ egrep inetd rarpd 

249 ? I 0;01 inetd 

541 p3 H 0:00 egrep inetd 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. If a pid shows up for rarpd, it is not necessary to re-exe- 
cute it as shown below.. 



||i||||j|||l|||||j|i|||«^ 


) 


Put the distribution tape into the drive and execute the following commands. 


( tapehost # /usr/ etc /rarpd -a 


) 



* * * NOTE * • • 

In the following example the install kernel will be named /var/tmp/install. The ac- 
tual name of the file is not important, so long as it is used consistently here and in 
the example on the next page. Also note that the filesy stem must have enough space 
to hold the install kernel. 
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In the mt command below, replace the variable X with one of the following values, 
depending on the type of system. 



Table 17. 



System 


Value of X 


SeriesS and 5E 


2 


Series6 


3 



For Exabyte tape drives, use bs=1024 instead of bs=512 in the dd command shown 
below. 

liiiipiiiHliiB^ 

Enter the following boot command on the system being installed: 

In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the tapehost's Internet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

The system will ask if you want to re-install if INSTALLED is not 0. 
Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

i^iK iK NOTE * * * 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
3.5 or higher. 

To load the ramdisk on SeriesS or SeriesSE, using a local CD-ROM drive, enter a 
boot command of the following form: 

|iiiiijiilliiljjB 
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To load the ramdisk on Series6 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 



('roM> boot sd. si (, 6,) /Install. Series6 



J 



To load the ramdisk on Series6 systems, using a local CD-ROM drive, off a Cougar 
controller, enter a boot command of the following form: 



(^ROM> boot sd.sv(2,6,0) /Install. SeriosS 



The bootROM copies the ramdisk image into memory and boots it: 



i 



f^Boot : sd.si ( , 6, ) /Ins tall. SeriesS 
Entry: OxffOSOOOO 
Size: 0xl60000+0x748e8+0x660c8 



A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4. 1 C contained on a remote disk 
accessed over the network. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



(^ ROM> setenv installed 



I 



The system will ask if you want to re-install if INSTALLED is not 0. 

If you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4.1C CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 



diskhost# mkdir /cdrom 
diskhost# mount 7dev/srO /cdarom 



The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
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192. 1 .3. 1 7. Also, the local machine must be listed in /etc/hosts, or in the NIS/YP 
hosts database, and ethernet address must be in /etc/ethers, or in the NIS/YF 
ethers database, in addition, diskhost must have the rarpd(8) daemon running. 



Since tftp( I ) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 



If the line starts with a #, remove the #. 

If a -s appears after the last in . tf tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

(^diskhost # ps aac J dgrep inetd " ~ ™™™™™- 

249 ? I 0:01 inetd 

541 p3 R 0:00 egrep inetd ^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(dis^JiS||ii|ii|||^^ 

In the boot command below, replace the variable X with one of the following val- 
ues, depending on the type of system 

Table 18. 



System 


Value of X 


Series5 and 5E 


5 


Series 6 


6 



Enter the following boot command: 

r ROM> b tf tp. «i i, , hostnuwber} /cdrom/Install ♦ SeriesX ~^ 

The bootROM copies the ramdisk image into memory and boots it: 

fBootz tf tp.ei (, ihostnumher) /cdrom/Install.SeriesX 

Entry; 0xff060000 
^Size: 0xl0e000+Dx56afb8+0xadc40 
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A Spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Diskful Installation 

Once the ramdisk is booted, it first determines what sort of terminal you are using. 
If you are using a serial terminal, that is, a terminal attached to the ttya/ttyb port, 
or if the bootROM variable CONSOLE is not set, the system displays a list of sup- 
ported terminals: 

1^1) 610 

2) ansi 

3) hp 

4) sun 

5) tvi912 

6) vtlOO 

7) wyseSO 



What type of terminal are you using ('1'. 



^7') 



If a frame-buffer is being used as the console, select the 4, the sun terminal type. 



I 



plllilH 



If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 

/^THIS SYSTEM IS ALREADY INSTALLED 



Do you want to re-install the system {'yes^, 
for help) ? 



" no S or '^ ? ' 



The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 



If the message appears, enter yes to re-install the mandatory system software. 
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The disk drives attached to the system are then scanned, and the system displays a 
menu of procedures: 

Haradisk 

1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 

Enter number of function to execute {^1',,'5', or *?' for 
help) : 



The provided functions are described as follows: 

Change Disk Partitioning - Allows the changing of the sizes of disk partitions, 
and what those partitions are to be used for filesystem space, swap space, or unused 
space. Refer to the Changing Disk Partitions Section for details on changing disk 
partitions. 

* * • NOTE * * * 

If you are going to make changes to the disk partitions on which OS/MP 4.1C will 
reside, make those changes before installing software. Disk partitions not contain- 
ing OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. See the section Software Instal- 
lation from the Ramdisk for more information. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesy stems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 
selectChange Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts the UNIX operating system after software installation. Al- 
ternatively, you may reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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You can request help at any ramdisk prompt by entering a question mark. Table 19 
shows edit commands available when entering text in response to prompts: 



Table 19, Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input line 


'^R 


redisplay input line 


AW 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


^L 


redisplay entire screen 


return C^M) 


end input 


newline (^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for *yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



# cd / 

# inst^sys 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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There are three information gathering menus: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

□ Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

□ Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification menu, enter continue. 

Example: 

Use the following steps to assign the /var filesystem to sdOd, rather than using the 
default of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 33, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 
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1} 
2} 
3} 
4) 
5) 



sdO: 
sdl: 



Standard' Filesystem Definition 

root on sdOa {re<5uired) 
swap on sdOb (required) 
/usr on sdOg (required) 
/var on root partition 
/tmp on root partition 

Disk Partitions (sizes in MB) 
(a) (b) (c) (d) (e) (f) 
8.4 32,4 191,1 9.3 
8.4 32.7 190.9 9.6 



(g) 

141,1 
140.8 



(h) 



Enter number of filesystem to change ('I'.-'S'), 'continue', ^previous', 
' cancel ' , or ' ? ' for help : 



Figure 33. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number: 4. 



Enter number of filesystem to change ('1'.,'5')/ 
^continues ^previous', ^cancel' or ^?' for help: 4 



The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



Enter name of disk partition or host:path for /var 
filesystem/ 'noneS •^C, or'?' for help: sdOd 



The new arrangement js displayed as shown in Figure 34. 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Installation Media Identification menu. 



Enter number of filesystem to change (^1',.'5'), 
'continue'/ 'previous', 'cancel', or '?' for help: continue 



Installation Media Identification Menu 

The Installation Media Identification Menu describes which media type (tape, CD 
ROM, or network directory) will be used during the installation. Figure 35 shows 
the Media Identification menu. 
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Standard Filesystem Definition 



1} 


root on 


sdOa 


(required) 


2} 


swap on 


sdOb 


(required) 


3) 


/usr on 


sdOg 


(required) 


4) 


/var on 


sdOd 




5) 


/tmp on 


root 


partition 

Disk Pai 




(a) 


(b) 


{c) 


sdO: 


8.4 


32.4 


191.1 


Sdl: 


8.4 


32.7 


190.9 



(d) (e) (f) 

9.3 

9,6 



(g) 

141.1 
140.8 



(h) 



Enter number of filesystem to change 
'cancel', or ^?' for help: 



< ' 1 ' . . ' 5 ' ) / ''continue ' , ^previous '■ 



Figure 34. Modified Standard Filesystem Definition Menu 



Installation Media Identification 

1) Installation media type ~ Tape 

2) Tape drive = /dev/nrstO 

3} Local Internet address = 0.0.0.0 ^required for remote tape) 

4) Network broadcast mask ~ OxffffOOOO {required for remote tape) 

5) Tape host = localhost (127.0.0.1) 



Enter selection number (^l'..''5')» ^continue'/ 'previous'/ 'cancel'/ or *?'for 
help: 



Figure 35. Installation Media Identification Menu - Local Tapehost 
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Local Tape Drive Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to local - 
host. The Installation media type must also be set to Tape. 

Remote Tape Drive Installation 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's/.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Intemet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 36 shows the Media Identification Menu of a system that is set up to install 
from a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO (/dev/ srl for 
sv2 on a Cougar controller) and the CD host field be set to 'localhost'. 
Figure 37 shows the Installation Media Menu with the CD-ROM parameters set to 
install from CD-ROM. 

Network and remote CD-ROM Installations 

Figure 38 shows the Installation media type menu with the Network parameters set 
to install from the network or a remote CD-ROM Installations of this type require 
that all the fields be set as follows:. 

Installation media type must be set to Network 
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Installation Media Identification 

1) Installation media type = Tape 

2) Tape drive - /dev/nrstO 

3) Local Internet address = 192.9.3.4 {required for remote tape) 

4) Network broadcast mask = OxffffffOO {required for remote tape} 

5) Tape host « tape-n-boot-serv {192,9.3,1} 



Enter selection number {^1',.'5')^ ^continue', 'previous'/ 'cancel' ^ or '?'for 
help: 



Figure 36. Installation Media Identification Menu - Remote Tapehost 



Installation Media Identification 

1} Installation media type ~ CD-ROH 

2} CD drive =? /dev/srO 

3} Local Internet address = 0.0.0.0 {required for remote tape) 

4} Network broadcast mask « OxffffOOOO {required for remote tape) 

5} CD host = localhost {127,0.0.1} 



Enter selection number {^1'..'5')^ 'continue', 'previous', 'cancel', or '?'for 
help: 



Figure 37. Installation Media Identification Menu - Local CD-ROM 
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Installation Media Identification 

1) Installation media type ~ Network 

2) Installation directory = /cdrom 

3} Local Internet address = 192.9,3,4 {required for remote tape) 

4) Network broadcast mask '^ Oxffff 0000 • {required for remote tape) 

5) Network host - ginger {192.9.3.1) 



Enter selection number (^1' 
help: 



'5M, * continue', ^previous', 'cancel', or ^?'for 



Figure 38. Installation Media Identification Menu -Remote CD-ROM 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /cdrom, then the installation path 
is simply /cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's/.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the installation directory, 
which is used to determine it's Internet address. 

For a remote CD-ROM install, the net host must have /cdrom in it's /etc/ex- 
ports file, and must export it. Also, the rpc.mountd(8), nfsd(8), and rarpd(8) dae- 
mons must be running on net host. 

When the details of the media have been entered correctly, enter continue. If 
You will be presented with the Package Selection Menu If the operating system has 
already been installed, you will be prompted to insert the optional software distri- 
bution media. 
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Package Selection Menu 

Use the Package Selection Menu to install optional Solbourne software distribu- 
tions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solbourne OS/MP Optional Software, is included on the OS/MP 
4.1C distribution tape. The following display shown in Figure 39 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size {KB) Install 

1) Solbourne OS/MP 4.1C Optional Software 34832 n 



Enter number of package to examine pl'..*l'), 'cancel', 'install', or '? 
for help: 



Figure 39. Package Selection Menu 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. You must examine the package if you want it installed. 



1 46 Installing OS/MP 4, 1 C on a Server 



To examine the modules available, select the Optional Software package: 

(^ Enter number of package to examine {'l'..*l'), 'cancel' , 
* install', or '?' for Jielp: 1 

Should the Solbourne OS/HP 4,1C Optional Software package 
V ^be installed i^yes' , 'no', '^C, or '?' for help)? yes 

The Should the Solbourne OS/MP 4 . IC Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu will appear as shown in Figure 40. 

• • * NOTE • * * 

Figure 40 is only an example, The free KB reported varies depending on the type 
and size of disk drive installed. 



^ ■ ...—..—.- 

Customization of Solbourne OS/MP 4.1C Optional 


Software 






Software 


Modules 




Module 


Sise(KB) 


Install 


Directory 


Free {KB) 


1) DEBUGGING 


2888 


y 


/usr 


58695 


2) GAMES 


3136 


y 


/usr 


58695 


3) MANUAL 


6992 


y 


/usr 


58695 


4} NETWORKING 


1096 


y 


/usr 


58695 


5) PLOT 


1784 


y 


/usr 


58695 


6) SECURITY 


320 


y 


/usr 


58695 


7} SV„PR0G 


1848 


y 


/usr 


58695 


8) SV_USER 


3144 


y 


/usr 


58695 


9) SYSTEM^V 


3992 


y 


/usr 


58695 


10) TEXT 


728 


y 


/usr 


58695 


11} VERSATEC 


5960 


y 


/usr 


58695 


12) UUCP 


608 


y 


/usr 


58695 


13) RFS 


912 


y 


/usr 


58695 


14) SHLIB 


1376 


y 


/usr 


58695 


15) TLI 


48 


y 


/usr 


58695 



Enter number of module to modify { *1' . . ''15' ) , ^continue' ^ *abort', or ^?' for 
help: 



Figure 40. Package Selection Customization Menu 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule' s name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 



Below are short descriptions of the individual modules: 
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DEBUGGING ■ program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sun window. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SAfP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG)andgraph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling Sun View applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter tro£f(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 
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RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• * • NOTE • * • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter nuiober of module to modify { ^l' . . *15' ) , 'continue' , 
^ abort ' , or * ? ' for help : 11 

The VERSATEC menu entry is highlighted, and: 

'^Modifying the Versatec printer support module 

Should the VERSATEC module be installed ('yes', 'no', "^C, 
^or '?' for help)? no ^ 

Figure 41 shows the updated display. 

* • * NOTE * * * 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 41. 

To install the GAMES module in /fun (on the root partition): 

/^Enter number of module, to modify Ol' , » *13' ) , 'continue' , 
I ' abort ' / or ' ? ^ for help : 2 
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Customization of Solbourne OS/MP 4*1C Optional Software 



Module 


Size (KB) 


1) 


DEBUGGING 


2888 


2) 


GAMES 


3136 


3) 


MANUAL 


6992 


4) 


NETWORKING 


1096 


5) 


PLOT 


1784 


6) 


SECURITY 


320 


7) 


SV_PROG 


1848 


8) 


SV^USER 


3144 


9) 


SYSTEM_V 


3992 


10) 


TEXT 


728 


11} 


VERSATEC 


5960 


12) 


UUCP 


608 


13) 


RFS 


912 


14) 


SHLIB 


1376 


15) 


TLI 


48 



Software Modules 




Install 


Directory 


Free (KB) 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


n 






y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 



Enter number of module to modify ( '1' , . '15' ) / * continue', 'abort', or ^?' for 
help: 



Figure 41. Package Selection Menu - Deletion of Versatec Module 
The GAMES menu entry is highlighted, and: 



^Modifying the games and demonstration programs module 

Should the GAMES module be installed {*yes', 'no'/ ^G, or 
'?' for help)? yes 

Install GAMES in what directory? /fun 

/fun does not exist. Create it during installation ('yes', 
^'no', '^C, or '?' for help)? yes ^ 

The menu is updated to reflect the change, as shown in Figure 42. 

* • • NOTE • • • 

The free space for /usr changes, and a completely new size (for /fun) is also dis- 
played as shown in Figure 42. 

If you decide to discard all changes made to the modules, use the command 
abort. This retums to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 43. 
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Customization of Solbourne OS/MP 4,1C Optional Software 



Software jModules 
Install 

y 
y 
y 
y 
y 
y 
y 
y 
-y 
y 
n 
y 
y 
y 
y 



Module 


Size (KB) 


1 


DEBUGGING 


2888 


2 


GAMES 


3136 


3 


MANUAL 


6992 


4 


NETWORKING 


1096 


5 


PLOT 


1784 


6 


SECURITY 


320 


7 


SV_PROG 


1848 


8 


SV^USER 


3144 


9 


SYSTEM_V 


3992 


10 


TEXT 


728 


11 


VERSATEC 


5960 


12 


UUCP 


608 


13 


RFS 


912 


14 


SHLIB 


1376 


15 


TLI 


48 



Enter number of module to modify {*!'., '15') 
help: 



rectory 


Free (KB) 


/usr 


67791 


/fun 


4579 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


/usr 


67791 


'^ continue' , 


^aborts 



or ' ? ' for 



Figure 42. Package Selection Menu - Install Games module to /fun 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size {KB} Install 

1) Solbourne OS/HP 4. 10 Optional Software 34832 y 



Enter number of package to examine P 1 ' , 
for help: install 



1'), * cancel 



install' 



Figure 43. Package Selection Menu 
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Actual installation begins at this point, and may require from 10 minutes (if only 
mandatory root files are being installed and a local tape drive is used) to about two 
hours (if everything is being installed from a remote QIC- 150 tape drive). 

The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 44). If 
the installation failed, call Customer Support. 

Ramdisk 

1) Change Disk Partitioning .... 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Snter number of function to execute {^1',.'5', or '?' for help): 4 



Figure 44. Ramdisk Menu 
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Rebooting from the Ramdisk 

When the Tape Change selection is displayed, type continue . 

After a successful installation^ start the UNIX operating system by rebooting as 
shown in Figure 45. 



Reboot System 



1) Boot Unix 

2} Boot on ramdisk 

3) Return to Main Menu 



Enter selection number {'1'., ."^B') or *'?' for help: 1 



Figure 45. Reboot System Menu 



Enter number offunction to execute (T.. '5', or '?' for help): 4 
At the Reboot System menu select Boot Unix: 

rEnter selection number (*1'*»*3') or *?' for h elp: 1 ^ 

If BOOTMODE is set to "manual", the system takes you to the ROM prompt 

(ROM>). 
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After selecting 1 there is a short pause, and then 

^Automatic boot enabled- Type Control~C to abort 
ROM> boot 

Boot: sd. si (0, 0, 0) /vmunix 
Entry: OxffOSOOOO 
Size: 0xd6000+0x33358+0x81548 



OS /MP 4-lC_Export (GENERIC/root) #0: Tue Feb 1 15:52:44 

1994 

Copyright (c) 1989--1994 Sun Microsystems, Inc. and 

Solbourne Computer, Inc. 

Now you must specify system configuration information. 

Disabling tftp 

If the ramdisk was loaded from a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system from which the tape 
was read. 

First, comment out the line, as shown below, in /etc/inetd.conf: 

|^#tftp dgrara udp wait root /usr/etc/in. tftpd in.tftpd 
l^/tftpboot 

Next, determine the process ID of inetd(8): 

rtapehost# PS a^c | egrep inetd 

249 ? I 0:01 inetd 

541 p3 R 0;0Q egrep inetd ^ 

T\iQ.pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

Last, signal inetd to re-read the configuration file: 



(l|||§^^i||l:i;iii||H 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



\ 



OS /MP 4.1C„Export (GENERIC /root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

[...] 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas: done. 

This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix. 

What is this system's name (default = 'standalone'): 
habitrail<Roturn> 

What is its Internet address (0 for none, default = 
192.9.3.4)? <Retum> 

What is the network broadcast mask (default = OxffffffOO)? 
<Return> 

What is the NIS domain name ('none' for none, default = 
'none')? Rodent . COM<R©tTirn> 

What directory should be used for automatic savecore files 
('none' for none, default = ' /var/crash/habitrail ' ) ? 
<Retum> 



• • • NOTE • yt * 
Using the default 'none' for the NIS domain name disables the NIS/YP services. 
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Time zone 


choices are: 




Australia/ 


GMT+11 


GMT- 3 


Brazil/ 


Gm'+12 


GMT- 4 


CET 


GMT+13 


GMT- 5 


CST6CDT 


GMT+2 


GMT- 6 


Canada/ 


GMT+3 


GMT-7 


Chile/ 


GMT+4 


GMT- 8 


Cuba 


GMT4-5 


GMT- 9 


EET 


GMT+6 


GMTO 


EST 


GMT+7 


GMTl 


EST5EDT 


GMT+8 


GMTIO 


Egypt 


GMT+9 


GMTll 


Factory 


GMT-0 


GMTl 2 


GB~Eire 


GMT-1 


GMTl 3 


GMT 


GMT-XO 


GMT2 


GMT+0 


GMT- 11 


GMT3 


GMT+1 


GMT- 12 


GMT4 


GMT+10 


GMT- 2 


GMT5 







A 


GMT 6 


Mideast/ 


GMT7 


NZ 


GMT8 


Nava j 


GMT9 


PRG 


Greenwich 


PST8PDT 


HST 


Poland 


Hongkong 


ROC 


Iceland 


ROK 


Iran 


Singapore 


Israel 


Turkey 


Jamaica 


UCT 


JapaSn 


US/ 


Libya 


UTC 


MET 


Universal 


MST 


W-SU 


MSTVMDT 


WET 


Mexico/ 


Zulu 



( V indicates time zone prefixes) 



Enter time zone (default ~ ^US/Mountain') : <Retum> 

What is today's date (mm/dd/yyyy, default = 2/1/1994)? <Retum>- 
What time is it (24-hour hh:mm, default == 16:55) "> <Return> 



Current settings are; 
Host name 
Internet address 
Network mask 
MIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



habi trail 

192.9.3.4 

OxffffffOO 

Rodent . COM 

/var /crash/habi trai 1 

US/Mountain 

2/1/1994 

16:55 



Are these correct (^yes' or 'no')? 
yes 

Setting netmask of eiO to 255.255.255.0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on habitrail. 

New password: 

Retype new password: 

Continuing boot 

starting rpc and net services: portmap [ 



.] 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is straight forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button. 

* * • NOTE * • • 

If automatic boot is enabled, interrupt the reboot by typing Control-C in the early 
stages of the reboot; otherwise the system will hang up as before 

Then bring up the system in single-user mode: 



,.,.,,,,., ,,;i|Ki|lil|iP^^^^ 



If the system booted successfully originally, you may instead log in as root: 



^habi trail login: root 
Password: 



In either case, if the file /etc/sys_conf /system-configured exists, that tells 
the system it has been configured, remove it: 



|lllllliljiiij 



The above file may not exist; this is not a problem. Go to the next step. 
Now reboot. If you are in single-user mode, exit: 

Otherwise, use fastboot: 



piiiiii^^ 



The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing on Series S4000 



Loading the Ramdisk 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

Loading the Local Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



||i|||||||i|l|||[|i;|J 



I 



The system asks if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4.1C distribution tape into the tape drive and enter the install 
command. If there is more than one tape drive, the bootROM asks which tape drive 
to use. For example: 

'^ROM> install 
Which type of device do you wish to install from: 

1) Tape 

2) Network 
Enter device type: 1 
You have the following tape drives. Please choose one: 

1) At Targe t4, drive name: ARCHIVE VIPER 150 2.1247-005 

2) At Targets, drive name: EXABYTE EXB-8200 2 5 IK 
Enter device number: 1 

The bootROM copies the ramdisk image into memory and boots it: 

I^Boot: St, si (,4,4) 



Entry: OxfdOSOOOO 

Size: 0xec000+0x53ab28+0x42ab8 



y 



The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following exam- 
ple, must be on the same network as the system being installed, referred to as ham- 
ster in the following example. For example, with a class C network, the first three 
numbers in the Internet addresses of the two machines must be the same, such as 
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192.1.3.42 and 192.1.3.17. Also, hamster must be listed in /etc/hosts, or in the NI- 
SA^P hosts database, and/.rhosts on tapehost. In addition, the ethemet address 
must be in the ethers database. The tapehost must also be running the rarpd(8) 
daemon.The ramdisk must be extracted from the OS/MP 4.1C distribution tape 
onto a disk on tapehost. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the tapehost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

tftp dgram udp wait root /usr/etc/in. tf tpd in.tftpd -s 
/tftpboot 

If the line starts with a #, remove the #. 

If a -s appears after the last in . tf tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

^tapehost # pe ax | egrep inetd ! ^ 

249 ? I 0:01 inetd 

541 p3 R 0:00 egrep inetd 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 



|||;||j|ii||||||||M 



* * * NOTE * • * 

In the following example the install kernel will he named /var/tmp/install. The ac- 
tual name of the file is not important, as long as it is used consistently here and in 
the example on the next page. Also note that the filesy stem must have enough space 
to hold the install kernel. 

Put the distribution tape into the drive and execute the following commands. For 
Exabyte tape drives, use bs=1024 instead of bs=512 in the dd command shown be- 
low. 

/^tapehost # cd /var/tit^ 

tapehost # mt -f /dev/nrstO asf 4 
l ^tapehost # dd i£g/dev/nrstO ofgjnstall bsg512 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



|jiilllljiiillj 



I 



The system will ask if you want to re-install if INSTALLED is not 0. Enter the 
install command, selecting network installation. In the following sample interac- 
tion, sample Internet addresses are shown. Where the system prompts for an Inter- 
net address, you should enter the value assigned to your system. 



/^ROM> install ' ' 

Which type of device do you wish to install from: 

1 ) Tape 

2 ) Network 

Enter device type: 2 

Enter internet address of this system (defaultsa.b.c.d) : 
192.9.3.4 

Enter internet address of remote tape system 
(default=a»b.c.d) : 

192.9.3.1 

Enter name of file to boot {default-/iisr/boot/munix.S4000} : 
/var/tmp/ install 

Using IP address 192.9.3.4 ~ C0090304 
Server at IP address 192.9.3.1 = C0090301 
Boot: tftp»ei (,1,1) /var/tmp/ install 
Entry: OxfdOSOOOO 
l ^Size: OxecOOQ'fQx53ab28+Ox42ab8 y 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



|lilllj|iii;lllilli^^ 



The system will ask if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 

|j;||||||g||lli;a|;i:M^ 

The bootROM copies the ramdisk image into memory and boots it: 

(^Boot: sd.si (, 6, ) /Install. S4000 

Entry: OjcfdOSOOOO 
^Sizet 00xea000+0x43b8b8+0x309a8 ^ 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4.1C contained on a remote disk 
accessed over the network. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

(iliiillliiiii^ 

The system will ask if you want to re-install if INSTALLED is not 0. 

If you are installing using a remote CD-ROM drive (via the network), install the 
OS/MP 4.1C CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 

/^disk:host# mkdir /cdrom 

I diskhost* moiint /dev/srO /cdrom 
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The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
192.1 .3.17. Also, the local machine must be listed in /etc/hosts, or in the NISA^P 
hosts database, and in /.rhosts on diskhost. In addition, the ethemet address 
must be in /etc/ethers, or in the NISAfP ethers database. 

diskhost must have /cdromin it's /etc /exports file, and must also be 
running the rpc .inountd(8) nf sd(8) and rarpd() daemons. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

tftp dgram udp wait root /usr/etc/in* tftpd in»tftpd -s 
/tftpboot _____________________________^ 

If the line starts with a #, remove the #. 

If a -s appears after the last in . tf tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

^diskhost # pa asK j ^gv^p i»«td 
249 ? I 0:01 inetd 
541 p3 R OiOO ^gr^p inetd 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(diskhost! kill ^HPP pid ■ ■ ") 

Enter the following boot command: 

(rOM> b t£tp^ei(,^i30£fti3umjber)/cdrom/nistall« 04000 ^ 
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Diskful Installation 

This section describes the procedure for installing diskful systems. 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 

A) 610 

2) ansi 

3) hp 

4) sun 

5) tvi912 

6) vtlOO 

7) wyseSO 
l ^What type of terminal are you using { ' 1 ' . . ' 7 ' ) ? 



If a frame-buffer is being used as the console, select the 4, the sun terminal type. 



||lii||jj|||pi|;;iij| 



I 



If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



/^THIS SYSTEM IS ALREADY INSTALLED 



Do you want to re-install the system {'yes', 'no', or 
for help) ? 



N o , 



The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. If the message 
appears, enter yes to re-install the mandatory system software. 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



Ramdisk 

1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 

Enter number of function to execute (*1''..'5', or *?' for 
help) : 



The provided functions are described below: 

Change Disk Partitioning - Allows changing the sizes of disk partitions, and what 
those partitions are to be used for, such as filesystem, swap, or unused. 

• * * NOTE • * • 

If changes are going to be made to the disk partitions on which OS/MP 4.1C will 
reside, make the changes before installing software. Disk partitions not containing 
OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 
select Change Disk Partitioningbefore attempting to Install Soft- 
ware. 

Reboot System - Starts the UNIX operating system after software installation. Al- 
ternatively, you may reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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You can request help at any ramdisk prompt by entering a question mark by itself. 
Table 20 shows edit commands available when entering text in response to 
prompts: 

Table 20. Input Editing Commands 



Character 


Interpretation 


backspace (^U) 


delete last input character 


delete (^7) 


delete last input character 


^U 


erase input line 


'^R 


redisplay input line 


^W 


delete input up to 7' or whitespace 


^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return (^M) 


end input 


newline (^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with "System error" or "Internal error" and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 

(^# ^Jstty sane^J 

# cd / 

# rm -f /core 
> ^# inst_syB 

where ^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solbourne customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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There are three information gathering menus: 

O Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

D Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

□ Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to retum to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earher menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. 



Any changes made to the standard filesystems with the partition tool will appear 
this menu. 



in 



Normally, no changes need to be made at^this menu. To proceed to the Tape Iden- 
tification Menu, enter continue. 

Use the following steps to assign the /var filesystem to sdOd, rather than using the 
default of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 46, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 
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Standard Filesystem Definition 



1) root on sdOa (required) 

2} swap on sdOb (required) 

3) /usr on sdOg (required). 

4) /var on root partition 

5) /tmp on root partition 









Disk Partitions (sizes 


in MB) 






(a) 


(b) 


(c) (d) (e) 


(f) 


(g) 


sdO: 


8.4 


32.4 


191.1 9.3 





141.1 


sdl: 


8.4 


32.7 


190.9 3.^ 





140.8 



(h) 



Enter number of filesystem to change ('1'..'5')/ 'continue',- 'previous', 
'cancel', or '?' for help: 



Figure 46. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number: 4. 



/^Enter number of filesystem to change ('1'..'5')/ 
l ^' continue', 'previous S 'cancel' or '?' for help: 4 

The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



Enter name of disk partition or host:path for /var 
filesystem, 'none', "^C, or'?' for help: sdOd 



The new arrangement is displayed as shown in Figure 47. 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Installation Media Identification Menu: 



Enter number of : filesystem to change ( ' 1 ' . . ' 5 ' ) , 
'continue', 'previous', 'cancel', or *?' for help: continue 



Installation Media Identification Menu 

The Media Identification Menu describes which media type (tape, CD ROM, or 
network directory) will be used during the installation. 

On Series S4000 systems, the default values are determined by how the ramdisk 
was booted. 
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Standard Filesystern Definition 



1) 


root on sdOa 


(required) 






2) 


swap on sdOb 


(required) 






3) 


/usr on sdOg 


( required) 






4) 


/var on sdOd 








5) 


/tmp on root 


partition 

Disk Partitions (sizes in MB) 








{a) (b) 


(c) (d) (e) (f) 


(9) 




sdO: 


8.4 32.4 


191.1 9.3 


141 


1 


Sdl: 


8.4 32.7 


190.9 9,6 


140 


8 



(h) 



Enter nuiuber of filesystern to change ('1'..''5'), ^continue', ^previous', 
' cancel ' , or ^ ? ' for help : 



Figure 47. Modified Standard Filesystern Definition Menu 

Figure 48 shows the Installation Media Identification Menu of a S4000 machine 
that was booted from a local tape device stO (SCSI address 4). 

Local Tape Drive Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to 'local- 
host'. The Installation media type must also be set to 'Tape'. 

Remote Tape Drive Installation 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's/.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 
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Itistallation Media. Identification 

1) installation jnedici type ~ Tape 
2)' Tape drive =s /dev/nrstO 

3) Local Internet address = O.OiO.O {required for remote tape) 

4) Hetwork broadcast mask - OxffffOOOO {required for remote tape) 

5) Tape host a localhost {127. 0.0*1} 



Enter selection titirfiber ,(*1* V . "^S*) > 'continue', 'previous', 'cancel', or '?'for 
help: - , , , , ^ 



Figure 48. Installation Media Identification Menu - Local Tapehost 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 49 shows the Media Identification menu of a system loading software from 
a remote tape using tape device stl (SCSI address 5). 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Local CD-ROM installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/ sr and the CD host 
field be set to 'localhost'. Figure 50 shows the Installation Media Identifica- 
tion menu with the CD-ROM parameters set to install from CD-ROM. 

Network and remote CD-ROM Installations 

Figure 51 shows the Installation media type menu with the Network parameters set 
to install from the network or a remote CD-ROM. Installations of this type require 
that all the fields be set as follows: 

Installation media type must be set to Network 
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Installation Media Identification 

1) Installation media type = Tape 

2) Tape drive ^ /dev/nrstl 

3) Local Internet address = 192.9.3,4 (required for remote tape) 

4) Network broadcast mask = OxffffffOO ^required for remote tape) 

5) Tape host - tape-n-boot-serv {192.9.3.1) 



Enter selection number (^1'..''5')* 'continue'/ 'previous', 'cancel' , or '?'for 
help: 



Figure 49. Installation Media Identification Menu - Remote Tapehost 



Installation Media Identification 

1) Installation media type « CD-ROM 

2) CD drive ~ /dev/srO 

3} Local Internet address = 0.0.0.0 (required for remote tape) 
4} Network broadcast mask - OxffffOOOO (required for remote tape) 
5) CD host = localhost (127.0.0.1} 



Enter selection number ('l'^..'5M» 'continue', 'previous', 'cancel', or ' ? ' f or 
help: 



Figure 50. Installation Media Identification Menu - Local CD-ROM 
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Installation Media Identification , 

1) Installation media type « Network 

2) Installation directory sr /cdroiti 

3) Local Internet address = 192,9,3.4 (required for remote tape) 

4) Network broadcast mask s= OxffffOOOO {required for remote tape) 

5) Network host ~ ginger {192.9.3.1) 



Enter selection number 
help: 



(*!'.. "5')* * continue', ^previous', 'canctel-'; or ^?'for 



_J 



Figure 51. Installation Media Identification Menu -Remote CD-ROM 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /usr/cdrom, then the installa- 
tion path is simply /usr/cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /.rhosts file. Check /etc/hosts or the NISAfP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the remote CD-ROM, 
and it's Internet address. 

For a remote CD-ROM install, the net host must have /cdrom in it's /etc/ex- 
ports file, and must export it. Also, the rpc.mountd(8), nfsd(8), and rarpd(8) dae- 
mons must be running on nethost. 

When the details of the media have been entered correctly, enter continue. If 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 
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Package Selection Menu 

Use the he Package Selection Menu to install optional Solboume software distri- 
butions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4.1C distribution tape. The following display shown in Figure 52 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1} Solbourne OS/MP 4. IC Optional Software 34832 



Enter nuinber of package to examine {*1'..*1'), ^cancel', ^install', or ^?' 
for help; 



Figure 52. Package Selection Menu 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 
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The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 

^ Enter number of package to examine ( * 1 ' .. . ' 1 ' ) * ^cancel', 
'install', or '?' for help:-! 

Should the Solbourne OS/MP 4.1C Optional Software package 
V ^be installed (VesS 'no^ '^C, or *?* for^help)? yes . - 

The Should the Solbourne OS/MP 4.1C. Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu will appear as shown in Figure 53. 

* • • NOTE • • • 

In Figure 53, the free KB reported varies depending on the type and size of disk 
drive installed. 



Customization 


of Solbourne OS/MP 4.1C Optional 


Software 






software 


Modules 




Module 


Size(KB) 


Install 


Directory 


Free (KB) 


1) DEBUGGING 


2888 


y 


/usr 


58695 


2) GAMES 


3136 


y 


/usr 


58695 


3} MANUAL 


6992 


y 


/usr 


58695 


4} NETWORKING 


1096 


y 


/usr 


58695 


5) PLOT 


1784 


y 


/usr 


58695 


6) SECURITY 


320 


y 


/usr 


58695 


7) SV_PROG 


1848 


y 


/usr 


58695 


8} SV„USER 


3144 


y 


/usr 


58695 


9} SYSTEM_y 


3992 


• y 


/usr 


58695 


10) TEXT 


728 


y 


/usr 


58695 


11} VERSATEC 


5960 


y 


/usr 


58695 


12} UUCP 


608 


y 


/usr 


58695 


13) RFS 


912 


y 


/usr 


58695 


14) SHLIB 


1376 


y 


/usr 


58695 


15) TLI 


48 


y 


/usr 


58695 



Enter number of module to modify {'1' 
help; 



^15')/ 'continue', 'abort', or '?' for 



Figure 53. Package Selection Customization Menu 
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The size of each module in kilobytes is listed immediately to the right of the mod- 
ule' s name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sun window. 

GAMES - games and demonstration programs 

The recreational programs listed in section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SAfP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling Sun View applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 
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TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• • • NOTE • • • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter number o£ module to modify -{*!',, ^15 O r 'continue', 
abort*/ or *?' for help: 11 

The VERSATEC menu entry is highlighted, and: 

(^Modifying the Verisafcec printer support module 
Should, the VERSATEC module , be installed, (*yes', ''no', '^C, 
or '?' for help) ? no' \,- ' - : ^ 

Figure 54 shows the updated display. 

• • • NOTE • • * 

The free space for Msr has been increased by the size of the VERSATEC module 
as shown in Figure 54. 

To install the GAMES module in /fun (on the root partition): 

Enter number of module to modify (U',,'13Mr * continue' , 
' abort ' , or ' ? ' for help ; 2 
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Customization of Solboume OS/MP 4.1C Optional Software 



Module 


Size (KB) 


1) 


DEBUGGING 


2888 


2) 


GAMES 


3136 


3) 


MANUAL 


6992 


4} 


NETWORKING 


1096 


5} 


PLOT 


1784 


6) 


SECURITY 


320 


7) 


SV_PROG 


1848 


8) 


SV_USER 


3144 


9) 


SYSTEM_V 


3992 


10) 


TEXT 


728 


11} 


VERSATEC 


5960 


12) 


UUCP 


608 


13) 


RFS 


912 


14) 


SHLIB 


1376 


15) 


TLI 


48 



Software 


Modules 




Install 


Directory 


Free (KB) 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


646S5 


y 


/usr 


64655 


y 


/usr 


64655 



Enter nuinber of module to modify {^'..'IS')/ ^continue', ^abort', or ^?' for 
help: 



Figure 54. Package Selection Menu - Deletion of Versatec Module 
The GAMES menu entry is highlighted, and: 

/^Modifying the games and demonstration programs module 

Should the GAMES module be installed {'yes', "no', '^C, or 
'?' for help)? yes 

Install GAMES in what directory? /fun 

/fun does not exist- Create it during installation {*yes', 
"no', '^C, or "?' for help)? yes 

The menu is updated to reflect the change, as shown in Figure 55. 

* • * NOTE • * * 

The free space for Aisr changes, and a completely new size (for /fun) is also dis- 
played as shown in Figure 55. 

If you decide to discard all changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 56. 
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Customization of Solfoourne OS/MP 4.1C Optional Software 



Module 


Size (KB) 


1 


DEBUGGING 


2888 


2 


GAMES 


3136 


3 


MANUAL 


6992 


4 


NETWORKING 


1096 


5 


PLOT 


1784 


6 


SECURITY 


320 


7 


SV_PROG 


1848 


8 


SV_USER 


3144 


9 


SYSTEM„V 


3992 


10 


TEXT 


728 


11 


VERSATEC 


5960 


12 


UUCP 


608 


13 


RFS 


912 


14 


SHLIB 


1376 


15 


TLI 


48 



Software 


Modules 




Install 


Directory . 


Free (KB) 


y 


/usr 


67791 


y 


/fun 


4579 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


-67791 


y 


/usr 


67791 


y 


/usr 


67791 


/ i'l' ,r 


15')/ * continue', 


* abort', 



or * ? ^ for 



help; 



Figure 55. Package Selection Menu - Install Games module to /fun 



Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1) Solbourne OS/MP 4 . IC Optional Software 34832 y 



Enter number of package to examine {*l'..'l'), 'cancels 'install', or '?' 
for help: install 



Figure 56. Package Selection Menu 
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Actual Installation 

Actual installation begins at this point, and may require from 10 minutes (if only 
mandatory root files are being installed and a local tape drive is used) to about two 
hours (if everything is being installed from a remote QIC- 150 tape drive). 

The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesystems (root(/), /usr, possibly /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 57). If 
the installation failed, call Customer Support. 

Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as shown in Figure 57. 

Ramdisk 

1) Change Disk Partitioning 

2} Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Enter number of function to execute {'1'..'5'/ or '?' for help): 4 



Figure 57. Ramdisk Menu 
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Enter number of function to execute ('r..*5', or *?' for help): 4 
At the Reboot System menu select Boot Unix: 

( Enter selection number ( ^ 1 ' , . ^ 3 ' ) ' or ^7' tot help: i ^ 

After selecting 1, there is a short pause, and then: 

'^Automatic boot enabled. Type Control-C to abort - :, - ^ 
ROM> boot 

Boot: sd.si (0, 0^ 0) /vmunix 
Entry: OxfdOSOOOO 
Size? 0xd6000+0x33358+0x81548 , ., 



OS/MP 4 , XC^Export (GENERIC/root ) ^#0 : - Tue Feb 1 , 15 : 52 : 44 ;. 

1994 - ^ .,-': ■' '■' ^ ' ',\ . . ' ^ ' ■■., ■ / , 

Copyright (c) -1989-1994 Stin Microsystems, Inc. and - 
Solbourne Computeri ' Inc.; ■ -l . '- 

Now you must specify the system configuration information must be specified. 

Disabling tftp 

If the ramdisk was loaded from a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system from which the tape 
was read. 

First, comment out the line, as shown below, in /etc/inetd.conf: 



#tftp dgram udp wait root /usr /etc/in. tftpd in.tftpd 
/tftpboot , . : ■ 



Next, determine the process ID of inetd(8): 

^tapehost# ps ax | egrep inetd ' 

249 ? X 0:01 inetd 

541 p3 R 0:00 egrep inetd ^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

Last, signal inetd to re-read the configuration file: 



3 



( tapehost# kill -HtTP pid 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4.lC_Export (GENERIC/root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 

Solbourne Computer, Inc. 

[...] 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas: done. 

This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix. 

What is this system's name (default ^ 'standalone'); 
habit rax I <Retum> 

What is its Internet address (0 for none-^ default = 
192.9.3.4)? <Retum> 

What is the network broadcast mask (default - OxffffffOO)? 
<Return> 

What is the JSfiS domain name {'none' for none, default = 
' none ' ) ? Rodent . COM <Retum> 

What directory should be used for automatic savecore files 
('none' for none, default = Vvar/crash/habi trail' ) ? 
<R6turn> 



• ••NOTE*** 

Using the default 'none' for the NIS domain name disables the NIS/YP services. 

Because you are installing a server, it is important that you obtain the system's 
name, internet address, and network mask from the site's resident system adminis- 
trator. 

The next window will ask for you to specify your time zone. If you enter one of the 
options as it appears on the screen, that has a prefix, a list of options for that prefix 
will appear. 
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Time zone 

Australia/ 

Brazil/ 

CET 

CST6CDT 

Canada/ 

Chile/ 

Cuba 

EET 

EST 

EST5EDT 

Egypt 

Factory 

GB-Eire 

GMT 

GMT+0 

GMT+1 

GMT+10 



choices are: 
GMT+11 
GMT+1 2 
GMT+1 3 
GMT+-2 
GMT+3 
GMT+4 
GMT+5 
GMT+5 
GMT+7 
GMT+8 
GMT+9 
GMT-0 
GMT~1 
GMT- 10 
GMT- 11 
GMT-12 
GMT -2 



GMT- 3 
GMT- 4 
GMT -5 
GMT -6 
GMT-7 
GMT- 8 
GMT- 9 
GMTO 
GMTl 
GMT 10 
GMT 11 
GMTl 2 
GMTl 3 
GMT2 
GMT3 
GMT4 
GMT 5 



GMT6 


Mideast/ 


GMT7 


,NZ 


GMT8 


Navajo, 


GMT9 


PRC 


Greenwich 


PST8PDT 


HST 


Poland 


Hongkong 


ROC 


Iceland . 


ROK 


Iran 


Singapore 


Israel 


Turkey 


Jamaica 


UCT 


Japan 


US/ 


Libya 


UTC 


MET 


Universal 


MST 


VJ-SU 


MST7MDT 


WET 


Mexico/ 


Zulu 



(V indicates time zone prefixes) 



Enter time zone (default ~ 'US/Mountain') : US <Return>' 

What is today's date {mm/dd/yyyy, default = 2/1/1994)? <Retuim> 
What time is it {24-hour hh;mm, default - 16:55)? <Il©turn> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



~ habi trail 

- 192.9.3.4 

= OxffffffOO 

™ Rodent.COM 

~ /var/crash/habi trail 

= US/Mountain 

^ 2/1/1994 

= 16:55 



Are these correct (^yes' or 'no')? 
yes 

Setting netmask of eiO to 255.255.255.0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password, for root 

Changing password for root on habitrail. 

New password: 

Retype new password; 

Continuing boot 

starting rpc and net services: portmap [ 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on. 

* * * NOTE * * * 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 

^ROM> boot -s ™ " ' '^ 

If the system booted successfully originally, you may instead log in as root: 

/^habi trail login: root 

1 ^ Password: ^ 

In either case, if a file exists that tells the system it has been configured, remove it: 

r#rm/etc/sys_conf/systein- configured ^ 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

r# exit J 

Otherwise, use fastboot: 

|ii|iBll|ii|illlliililllii^ 

The system asks configuration questions just as it did the first time it booted after 
being installed. 



1 82 Installing OS/MP 4. 1 C on a Server 



Installing Diskless Clients 
on Sun and Solbourne 
Servers 



The commands config_server and install_client automate the installation of disk- 
less clients. 

config_server sets up a prototype area for clients of a particular architecture (i.e. 
S4000 at OS/MP 4.1B). 

instalLcIient sets up a unique area for each individual client. 

You may set up a network in which either a Solbourne or a Sun acts as the server. 
The clients may be either Solbourne or Sun systems. The clients need not be at the 
same OS release level as the server or each other. 

The necessary steps depend on your arrangement, and are discussed in the follow- 
ing subsections. 

1 . Installing the correct config_server 

If the server is a Sun, or a Solbourne not running OS/MP 4.1C or later, you must 
install and configure a new version of config_server. 

If the server is a Solbourne system running OS/MP 4. IC or later, or if the preinstall 
utility was installed, it already has the necessary version of config_server. Skip the 
Installing config_server subsection and go to Configuring the Server. 

2. Running config_server 

3. Running install_client 

4. Booting the client 

• * * NOTE * * • 

An OS/MP 4. IC server can support any Solbourne S4000, SeriesS, or Series6 cli- 
ents at OS/MP 4.1 Cor Series4 at OS/MP 4.1A.3. It can also support Sun clients 
running SunOS. 

Installing config_server 

This procedure is necessary only for systems not running OS/MP level 4.1C, or 
systems not using the preinstall utility. It can be used for any type of Sun or Sol- 
bourne system. 

When using a local tape drive, install config_server using the following com- 
mands: 



^# mt -f /dev/nrstO asf 5 

# cd /usr/etc 
v^# tar xgt /dev/nrstO 



Installing OS/MP 4.1C on a Server 183 



When using a remote tape drive, the system name needs to be in the tapehost 
/.rhosts file. Install config_server using the following commands: 

r# XBH -n tapehost mt -f /dev/nrstO asf 5 ^ 

# cd /lasr/etc 

^# rsh -n tapehost dd iJE«*/dev/nrgtO bgwSk ) tar acpBJE -' ^ 

In this example, you should replace tapehost with the actual name of your tape 
host machine. 

* * * NOTE * • • 

Some older versions of SunOS do not support the 'asf request for mi. If this is the 
case for your tape host, first substitute 'rew'for 'asf 5' in the above example, and 
then re-execute mt with fsf5' instead of 'rew'. 

When using a local CD-ROM drive, install config_server using the following 
commands: 

f§ nikdir /cdrom 

# mount /dev/srO /cdrom 

# cd /tisr/etc 

# tar 3cp£ /cdrom/TooXs^tar , . 

When installing over the network, or when using a remote CD-ROM drive, create 
a mount point directory (if one doesn't exist), and mount the CD-ROM drive on the 
remote machine, referred to here as nethost, as follows: 

J'net.ost* ^Ocai. ,=a.<« 

V ^nethostt mount /dev/srO /cdrom ^ 

Install config_server using the following commands: 

/^# cd /usr/etc ' 

V# rslx -n nethost dd i£s/cdrom/Tools«tar bsaSk | tar xpBf -, 

In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 
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Configuring the Server 

The command config_server installs executables on the server for use by one or 
more client systems. The executables are placed in /export directories, as de- 
scribed below. Since the /export directories may grow to be quite large, you may 
wish to have /export be a link to a file system with more space, for example: 



tf|lllli(|liiilli|i 



ill 



Wn 



iiiiiHiiiiiiiiii;i?iiiii^iii: 



If you wish to use a directory other than /export, set the environment variable EX- 
PORT_DIR to the directory that you desire: 



Ci 



setenv EXPORT_DIR /usr /clients j 

When installing from tape, config_server prompts for a carriage return, which you 
enter after loading the tape containing the required files for the specified architec- 
ture. 

config_server accepts several options and arguments. The following are the most 
commonly used: 

□ The -f option specifies the tape drive from which the software will be loaded 
onto the server. In the examples, /dev/nrstO is the value used. When accessing 
a remote tape drive, use a value of the form tapehost:tapedrive. 

If the software that will be loaded onto the server is from a CD-ROM disk, or 
the mount point of the CD-ROM, the -f option specifies the pathname from 
which to read architecture-dependent directories. 

O The -c option is used to specify a selected tape/on-disk configuration file. 

If you are using a CD-ROM disk or a remote system over the network, you will 
need to specify this option and one of the following three configuration files: 
s4000-cd, s5-cd and s6-cd. These configuration files contain the required root, 
usr and kvm tar files. They also contain the optional tar files for 4. IC, and may 
be added by editing the corresponding configuration file and taking out the "#" 
at the beginning of each line. 

If the server is a Solboume, and the client is a Sun, use one of the configuration 
files in /usr/etc/setup corresponding to the architecture, operating system, and 
media of the client. You may also create a configuration file for any Sun tape 
or CD-ROM. Refer to the config_server(8) man page. 

O The -n option specifies the operating system and release level of the client 
systems, where these differ from the server. It is also used when clients with 
the same architecture are not all running the same release level. 

The values used may be any you wish, provided you are consistent when 
running the config_server and install_client commands. For example, you 
could use the values osmp.4.1B, osmp.4.1C, or sunos.4.1.1. 
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The result is to create subdirectories of /export named such that the machine 
type is the basename and the OS release is the extension. 

□ client_arch, the final argument to config_server, specifies the machine 
architecture of the client, such as Series5, Series6, S4000, sun4, sun4c. 

Run config_server as many times as necessary to support the variety of machine 
architectures, operating systems, and release levels in use by clients on your net- 
work. 

A number of examples are presented here. For additional details, refer to the con- 
fig_server(8) man page. 

The first example configures a Solboume OS/MP 4.1C server for a Series5 client 
also running OS/MP 4.1C. On the Solboume server enter the following: 



iiiiiiiiiSiSiiiiiiiililB 



The next example configures a Solboume server running OS/MP 4.1C for a pair of 
Solboume S4000 clients, one at 4.1C and the other mnning 4. IB . 

f^# /usr/etc/S6tup/config„server -f /dev/nrstO S4000 

# /usr/etc/setiip/config_„se3rwer -f /dev/nrstO -n osinp.4.1B 
^84000 

Notice that the first invocation of config_server shown above did not use the -n 
option, by default supporting the client at the same release level as the server. The 
second example used the -n option, since the server and client are at different re- 
lease levels. 

The next example is for a Series6 server which supports a Sun 4 client mnning Sun- 
OS 4.1: 



# /usr/etc/setiap/confxg_server -f /dev/nrstO -zi sunos;4«l 
-c siin4~4*l-tl*4 sun4 



The last example is mnning config_seryer from 4. IC software on a CD-ROM disk 
for a Solboume OS/MP 4.1C server which supports Solboume S4000 clients, Se- 
ries5 clients, and Series6 clients respectively: 

/^# /usr/etc/setup/config_server -f /cdrom -c \ 
/usr/etc/setup/s4000-cd S4000 

# /usr /etc/setup/ config_server -f /cdrom -c \ 
/usr/etc/setup/sS-cd SeriejsS 

# /usr/etc/setiip/config_server ~f /cdrom -c \ 
/usr/etc/setup/s6-cd Series6 



Replace cdrom with the actual path name or mount point on the local host. 
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For a remote CD-ROM, the remote host must have Icdrom in it's /etc/exports file, 
and must export it. Also, the rpc.mountd(8) and nfsd(8), daemons must be run- 
ning on the remote host. First mount the cdrom on the remote host, then mount the 
remote host on the local host. 



reinotehost# mkdir f cdrom 
V ^remQtehost# mount /d6v/8rO f cdrom 



^localhost# mkdir /cdrom 

\ ^localhost# mount remotehostt / cdrom /cdroTa'- 

This concludes the examples of config_server. 

After running config_server, add the client to the /etc/hosts and /etc/ethers files, 
or the corresponding network information services databases (NIS/YP). 

If the server is using NIS/YP, /etc/ethers and /etc/hosts must be modified on the 
master server. config_server does not update NISA^P; this must be done manually. 

If the server is not using NIS/YP, the domain name must be set to "none" for in- 
stall_client to work correctly. 

* * * NOTE • • * 

/etc/ethers must not start with a blank line. 

Installing Clients 

The install_client command installs the diskless client on the server. It creates the 
client's root filesystem under the server's /export/root directory, links the client's 
/usr to the appropriate /export/exec directory, and sets up the client's kernel-spe- 
cific files, such as /vmunix. After running instalLclient on the server, the client 
can boot as soon as the client's bootROM variables are set correctly. 

The install_client command accepts a number of options and arguments. The fol- 
lowing are the most commonly used: 

O The -n option. If you used the -n option to config_server when setting up the 
server for this client, be sure to use it in the same way when invoking 
install_client. If necessary, examine the subdirectory names in /export/exec 
on the server; when you find the relevant subdirectory, the portion of the name 
after the first dot is the value to use for the -n argument. 

O The client argument identifies the name of the client being installed. 

□ The machine_arch argument specifies the type of machine in the client, such 
as Series5, Series6, S4000, sun4, sun4c. 

Other options and further details are discussed in the install_client(8) man page. 
The examples which follow parallel the server configuration examples. 
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Example install_client Command Lines 

The first example installs a Solboume OS/MP 4. IC client (named ' 'rootbeer") on 
a SeriesS server which also run OS/MP 4. IC. On the Solboume server enter the fol- 
lowing: 

f # /usr/etc/setup/iiistall„cXient rootbeer SeriesS _~Z) 

The next example installs a pair of Solboume S4000 clients, one mnning OS/MP 
4.1C ("rootbeer") and the other mnning 4. IB ("lemonade"), on a Solboume serv- 
er mnning OS/MP 4.1 C. 

/^tt /usr/etc/setttp/instaXI_cXient rootbeer S4000 

# /usr/etc/setxip/instaXl_cIxent -zx osinp.4.XB Xexnonade 
^S4000 ______^ ' 

Note that the first invocation of install_client shown above did not use the -n op- 
tion, by default placing the client at the same release level as the server. The second 
example used -n since the server and client are at different release levels. 

The next example is for a Sun 4 client, mnning SunOS 4.1, on a Solboume server 
mnning OS/MP 4. IC: 



(^ # /usr/etc/setup/instaXX_cXient -n smios.4.X candybar siiiiT) 



* * * NOTE * * * 

install_client modifies only the /oca/ /etc/bootparams. If the server is using NIS/- 
YP, /etc/bootparams must be modified on the NIS/YP master server. 

This concludes the examples of install_client. 
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Installing OS/MP 4. IC on 
a Server using reinst_sys 



This chapter describes how to install OS/MP 4.1C on a server using the utility, 
reinst_sys, which allows you to upgrade your system with a full installation of the 
operating system on unused partitions of one or more disks, while staying up in 
multi-user mode. 

A server is a system that provides NFS disk services. 

The purpose of reinst_sys is to minimize downtime by performing a full install of 
OS/MP onto a new system disk while the system continues to run an earlier version 
on an old system disk. Once reinst_sys is complete, you are free to do whatever 
local modifications are desirable before booting from the new disk. 

For example, you might reconfigure the OS/MP 4. IC kernel or modify files of local 
interest such as /etc/printcap. Only when the new system disk is ready to run do 
you need to halt the old system and reboot from the new disk. 

Finally, unlike earlier full install releases, reinst_sys makes it possible to fall back 
to the earlier version of OS/MP if there turns out to be some problem with the way 
you set up the new system. To fall back to the old system, halt the new system, 
change ROM variables DEFAULTROOT and perhaps DEFAULTSWAP, and 
then boot. 

* * • NOTE * * • 

In order to use this utility, you must have an unused disk, or at least enough unused 
partitions, on which to install the OS/MP 4.1 C release. You can not use reinstjsys 
to install over the currently running disk partitions. If you do not have an unused 
disk for reinstjsys to use, you will have to install OS/MP 4.1 C from scratch, while 
the system is unavailable to your users, as was done in previous OS/MP full instal- 
lation releases. 

You should not install on a disk connected to a channel board as it will be impos- 
sible to boot from that device. 
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Before Installing... 



* * * NOTE • * • 

Before using reinst_sys, you must know what disk(s) and partitions you want to in- 
stall on. If changes need to be made to any of the disks partitions, you must do this 
prior to running reinst_sys. Use partition(8) to modify the disks. 

It is best to select a disk that will be recognized by an OS/MP 4.1 C generic kernel. 
Otherwise it will be necessary to reconfigure the kernel (which may be desirable 
anyway) before rebooting. This is discussed in more detail at the end of this sec- 
tion. 

-kiric CAUTION • * • 

If installing by tape, dean the tape drive on the machine you will be using be- 
fore installing the release tape. Failure to do so may damage the release tape. 

Starting in OS/MP 4.1C, the preinstall utility is available to help determine which 
system files should be restored or merged from backup, preinstall shows which 
files in system directories were modified after you last installed the OS version 
you're currently running. 

If you do not want to use preinstall, skip to the Extracting reinst_sys section be- 
low. 



Installing preinstall. 



Because preinstall was not included in versions of OS/MP prior to 4.1C, it is nec- 
essary to install it before proceeding to install OS/MP 4.1C. 

When using a local tape drive, install preinstall using the following commands: 

/^# «it -f /d©v/nrsfcO asf 5 

# cd /usr/etc 

# tar acpg /dev/nrstO ___^ 

When using a remote tape drive, the system name needs to be in the tapehosts 
/.rhosts file. Install preinstall using the following commands: 

# rsh -n tapehost mt --f /dev/nrstO asf 5 

# cd /usr/etc 

# reh -n tapehost dd i£«/dev/nrstO bgasSk j tar xpB£ - 

In this example, you should replace tapehost with the actual name of your tape 
host machine. 



* * * NOTE * • • 

Some older versions of SunOS do not support the 'asf request for mt. If this is the 
case for your tape host, first substitute 'rew'for 'asf 5' in the above example, and 
then re-execute mt with Jsf5' instead of 'rew\ 
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When using a local CD-ROM drive, install preinstall using the following com- 
mands: 



ff inkdir /cdrom 

# motint /dev/srO /cdrom 

# cd /usr/etc 

v^# tar xp£ /cdrom/ToolB.tar 



When installing over the network, or when using a remote CD-ROM drive, create 
a mount point directory (if one doesn't exist), and mount the CD-ROM drive on the 
remote machine, referred to here as nethosts, as follows: 



nethost# jnkdir /cdrom 
^nethQst# motmt /dev/srO /cdrom 



Install preinstall using the following commands: 



^# cd /tasr/etc "^ 

v# rsb -n nethost dd if»/cdrom/Tools>tar bs»8k | tar xpBf ~J 

In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 

Using preinstall 

After preinstall has been installed, it is located in/usr/etc. The usage of preinstall 
is as follows: 

/usr/etc/preinstall [ -1 H -c mmddhhmm[yy] ] 

The preinstall command is used to look for files that should be saved prior to doing 
a full install of a new version of OS/MP. It looks on the system partitions (root(/), 
/usr, and /var) for files which have been touched after the date of the last full install 
of OS/MP (or, if given a cutoff date, files touched after that date). 

preinstall is normally used just before installing a new version of OS/MP to deter- 
mine what system-related files should be backed up. Then, after installing the new 
version of OS/MP, you can merge or restore these files into the newly-installed sys- 
tem. 

Some files, such as /etc/fstab, can typically be re-used without modification. Oth- 
ers, such as kernel configuration files in /usr/kvm/sys/*/conf, must be hand- 
merged into the new version of the OS with careful consideration of how the new 
OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. 
These files are normally updated by system operation and do not need to be backed 
up. Examples of excluded files are: /etc/mtab, the /var/sadm accounting files, the 
/tmp_mnt automounter directories, and patched kernel object files in 
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/usr/kvin/sys/*/OBJ. By default, the cutoff date used is the modification date of 
the file /etc/sys_conf^system-configured, which is touched the first time you boot 
a new version of the OS after a full install. You may want to use some other cutoff 
date with the -c option if the current OS was installed in some non-standard way. 

By default, the files and directories newer than the cutoff are listed to standard out- 
put by name, one per line. By using the -1 option, the output is in long form (as from 
the -Is option to find), showing the type, date, and size of each file. 

The following options are accepted by preinstall; 

a The -I option presents the output in long form, showing inode number, size in 
kilobytes (1024 bytes), protection mode, number of hard links, user, group, 
size in bytes, and modification time. If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic 
link the pathname of the linked-to file is printed preceded by *- >'. The format 
is identical to that of find -Is. 

D The -c option specifies to use the given cutoff date to decide which files to 
print, rather than the date of the file /etc/sys_conf^system-configured. The 
cutoff date format is -c mmddhhmm[yy], with month, day, hour, minute, and 
optional year in numeric form. This is the same format as for/usr/5bin/touch. 

reinst_sys has been modified since OS/MP 4. IB, so be sure to extract the new ver- 
sion from the OS/MP 4.1C media. If you installed preinstall as shown above, then 
the server already contains the version of reinst_sys that it needs and you may skip 
to the Installing section below. 

Extracting reinstjsys 

The following explains four different methods of extracting reinst_sys into the /us- 
r/etc directory. You must be logged in as root. 

Extracting reinstjsys via a Local Tape Drive 

''lllllllllllljli 
|||||i||y||!||iL§|||i^^^ 

Extracting reinst_jys via a Remote Tape Drive 

Routing from the system being installed to the tapehost must exist. Refer to the Sys- 
tem Network and Administration Gw/Je (101481). The local machine must be listed 
in /etc/hosts, or in the NIS/YP hosts database, and /.rhosts on tapehost. 

f% rsh -n tapehoBt mt *-f /a©v/nrstO asf 5 

# cd /iisr/etc 

# rsh ~n tapehost dd ifa/dev/nrstO l)S«81c | tar atpBf -> 
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Extracting reinst_sys via a Local CD-ROM Drive 

Create a mount point directory (if one doesn't exist), mount the CD-ROM drive, 
and extract reinst_sys as follows: 

/^# inkdir /cdrom ^ 

# moxmt /dev/srO /cdrom 

# cd /usr/etc 

^# tar xp£ /cdrom/Tools.tar 

Extracting reinst_sys via a Remote CD-ROM Drive or the Network 

When installing over the network, or when using a remote CD-ROM drive, create 
a mount point directory (if one doesn't exist), and mount the CD-ROM drive on the 
remote machine, referred to here as net hosts, as follows: 

|^nethost# mkdir /cdrom " 

V ^nethost# inount /dev/srO /cdrom 

Install reinst_sys using the following commands: 

|^# cd /usr/etc 

V# rsli -n nethost dd lf»/cdrojn/'goola»tar bgwSk j tar aq>S£ -> 

In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 
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Installing... 



This section covers the OS/MP 4.1C installation on Series5, SeriesSE, Series6 and 
S4000 systems. 

During installation, you can request help at any prompt by entering a question 
mark. Table 21 shows edit commands available when entering text in response to 
prompts: 

Table 21. Input Editing Commands 



Character 


Interpretation 


backspace (-^H) 


delete last input character 


delete (^?) 


delete last input character 


^U 


erase input line 


'^R 


redisplay input line 


A^ 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return (^M) 


end input 


newline ('^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as *co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



# riti -£ core 

# /usr/eto/r0inst_sys 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solbourne customer support. 
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Installing Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 

There are three information gathering menus: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

O Installation Media Identification - Determines the installation media from 
which to install (tape, CD-ROM, or network directory), and determines where 
that media is located. 

D Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to retum to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the shell terminating remst_sys. 

previous always returns to the previous menu (which is the shell, in the case of the 
Filesystem Definition menu). The changes discarded in this case are those made in 
the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to the standard filesystems with partition(8) will appear in this 
menu. 

reinst_sys has the following options: 

reins t_sys [-m] [-n] [-r /root/path] [-f host:/device/path] [-a arch] 

-m Don't mount or newfs filesystems 

-n ' Don't newfs filesystems 

-r /root/path Pretend /root/path is really / 

-f host:/device/path What tape device to use 

-a arch What cpu architecture to use - overrides cpustatus 
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In general, you will not need to use any of these options except perhaps the -a op- 
tion. The -f option will be set while running reinst^sys. 



The -a option is to be used when you are upgrading or changing the architecture of 
your machine. Suppose you have a machine with Series5 CPUs, and you want to 
upgrade to Series6 CPUs. To install the OS/MP 4.1C for Series6, log in as root and 
issue the following command: 



|i|iiij|ji|ii|i|;iifi^ 



To install OS/MP 4.1C with no change in architecture, log in as root and issue the 
command: 



|ili§iBiiiicii^iini|ii^ 



reinst_sys begins by reading the current /etc/fstab file to determine the disks at- 
tached to your system (mounted disks are also probed). 

After examining all attached disks, reinst_sys presents the first menu, the Standard 
Filesystem Definition menu. 

The root, swap, and usr partitions are required and must be defined before going to 
the next menu. The swap will be defined as the current swap area, and may be re- 
defined if you wish. The root and usr areas need to be defined from the currently 
available disk partitions that are highlighted in the Standard Filesystem Definition 
menu. For a disk partition to be available for use in reinst_sys, it must not be cur- 
rently mounted, and it must not have an entry in the /etc/fstab file. 

Example: 

Currently, the root(/) filesystem is on sdOa, swap is on sdOb, and the /usr filesys- 
tem is on sdOg. Available partitions are highlighted. If the necessary partitions are 
not available, exit reinst_sys. A partition may not be available because it is mount- 
ed or an entry exists for it in the /etc/fstab file. Also, it may not be available be- 
cause it does not exist, or it is not large enough, in which case you will need to run 
partition(8) to repartition the disk as needed. 

Use the following steps to assign the root (/) filesystem to sd2a, the /usr filesystem 
to sd2g, and the /var filesystem to sd2d (rather than using the default of /var being 
a subdirectory of the root filesystem). Leaving swap on the disk may be desirable. 

The steps for changing /var are optional. This makes use of partition d, thus using 
9.5 MB of disk space that is not used when the default disk partition is used with 
the standard filesystem definition. 

In Figure 58, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any sufficiently large available partition of any disk. 
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Standard Filesystem Definition 

1) root (required) <not defined> 

2} swap on sdOb (required) 

3) /usr (required) <not defined> 

4) /var on root partition 

5) /tmp on root partition 

Disk Partitions (sizes in MB) (available highlighted) 
(a) (b) (c) {d) {e) (f) (g) (h) 

sdO: 8.4 32.4 191.1 9.3 — —- 141.1 

sd2: 8.6 32.9 484.9 9,5 — — 433.5 



Enter number of filesystem to change {'1'..'5'), * continue', 'previous', 
* cancel ' , or * ? ' for help : 



Figure 58. Sample Standard Filesystem Definition Menu 
To modify the root (/) filesystem, enter the number 1 . 

/'Enter number of filesystem to change ( ^ 1 ' . . * 5 ' ) , 

[ 'continues ^previous', 'cancel' or ^?' for help: 1 

The root menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2a. 

^Enter name of disk partition or host:path for /root 
[filesystem, 'noneS '^C, or'?' for help: dd2a 



To modify the /usr filesystem, enter the number 3. 



Enter number of filesystem to change ('1'..'5')/ 
'continue', 'previous'/ 'cancel' or '?' for help: 3 

The usr menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2g. 

Enter name of disk partition or hosttpath for /usr 
filesystem, 'none', '^C, or'?' for help: sd2g 

To modify the /var filesystem, enter the number 4. 

I^Enter number of filesystem to change (' 1 ' , . ' 5 ' ) , 
I 'continue', 'previous'^ 'cancel' or '?' for help: 4 



198 Installing OS/MP 4. 1 C on a server using reinst_sys 



The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2d. 



Enter name of disk partition or host:path for /var 
filesystem, 'none', ^C, or*?' for help:- fid2d 

The new arrangement is displayed as shown in Figure 59. 



standard Filesystem Definition 



1) root on sd2a (required) 

2) swap on sdOb (required) 

3) /usr on sd2g (required) 

4) /var on sd2d 

5) /tmp on root partition 



sdO: 
sd2: 



Disk Partitions (sizes in MB) (available highlighted) 
(a) (h) (c) (d) (e) (f) (g) (h) 

8.4 32.4 191.1 9.3 -— — - 141.1 
8.6 32.9 484.9 9.9 -— —- 433.5 



Enter nuitiber of filesystem to change {"!'., '5'), 'continue', 'previous', 
'cancel', or '?' for help: 



Figure 59. Modified Standard Filesystem Definition Menu 

Once all changes for the standard filesy stems have been made, enter continue 
to proceed to the Installation Media Identification menu. 



Enter number of filesystem to change ('l'..*5'), 
'continue', ^previous', ''cancel', ox ''7' for help: continue 



Installation Media Identification Menu 

The Installation Media Identification menu describes which media type (tape, CD- 
ROM, or network directory) will be used during the installation. Figure 60 shows 
the Installation Media Identification menu. 

Installing from a Tape Drive 

Installing from a local tape drive requires that the Installation media type be set to 
Tape, the rape Jnve field be set to either stO or stl (the only supported tape 
drives) and that Tape host be set to localhost. 
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Installation Media Identification 

1) Installation media type t^ Tape 

2) Tape drive = /dev/nrstO 

3) Local Internet address = 192.9.3.4 {required for remote tape) 

4) Network broadcast mask ~ OxffffffOO {required for remote tape) 

5) Tape host - localhost (127.0.0.1) 



Enter selection number (^l'.-'5')» 'continue'^ 'previous'/ 'cancel^ or.'?'for 
help: 



Figure 60. Installation Media Identification Menu - Local Tapehost 

Installing From a Remote Tape 

Installation media type must be set to Tape. 

Tape drive should be the base name of the tape drive on the tapehost, either stO 
or stl. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host' s /.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape (rootbeer in this 
example), which is used to determine the tape host's Internet address. 

Figure 61 shows the Installation Media Identification Menu of a system that is set 
up to install from a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. 
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Installation Media Identification, 

1) Installation media type ~ Tape 

2) Tape drive = /dev/nrstO 

3) Local Internet address = 192,9.3.4 {required for remote tape) 

4) Network broadcast mask - OxffffffOO {required for remote tape) 

5) Tape host = rootbeer {192.9.3.1) 



Enter selection number (*!' 
help: 



,^5'), ^continue', 'previous'/ 'cancel'./ or '?'for 



Figure 61. Installation Media Identification Menu - Remote Tapehost 

Local CD-ROM Installation 

Installing from a local CD-ROM drive requires that the Installation media type be 
set to CD-ROM, the CD drive field be set to /dev/srO, and the CD host field be 
set to localhost. 

Figure 62 shows the Installation Media Menu with the CD-ROM parameters set to 
install from CD-ROM. 

Network and remote CD-ROM Installations 

Installation media type must be set to Network . 

Installation directory should be the full path name of the location of the installa- 
tion area, OR the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /cdrom, then the installation path 
is simply /cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host' s /.rhosts file. Check /etc/hosts or the NIS A^P 
hosts map as appropriate, 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 
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Installation Media Identification 

1) Installation media type ~ CD-ROM 

2) CD drive ~ /dev/srO 

3) Local Internet address = 192.9.3.4 {required for remote install) 

4) Network broadcast mask ~ OxffffffOO {required for remote install) 

5) CD host =: localhost {127.0,0.1) 



Enter selection ntiinber (^l'..'*5'), * continue '^ 'previous', 'cancel', or '?'for 
help: 



Figure 62. Installation Media Identification Menu - Local CD-ROM 

Network host must be set to the name of the system with the installation directory 
(rootbeer in this example), which is used to determine its Internet address. 

For a remote CD-ROM install, the nethost must have /cdrom in it's /etc/ex- 
ports file, and must export it. Also, the rpc.mountd(8), nfsd(8), and rarpd(8) dae- 
mons must be running on nethost. 

Figure 63 shows the Installation Media Menu with the values set for a network in- 
stallation. 

Once the details of the media have been entered correctly, enter continue to pro- 
ceed to the Package Selection Menu. 

Package Selection Menu 

Use this menu to install optional Solboume software distributions. It provides a 
menu-driven method of examining the components of the distribution tape, select- 
ing the parts to be installed, and specifying the directories where the components 
will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 
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Installation Media Identification 

1) Installation media -type *= Network 

2) Installation directory « /cdrom 

3) Local Internet address = 192.9.3.4 {required for remote install) 

4) Hetworlc broadcast mask - OxffffffOO {required for remote install) 

5) Network host - rootbeer (192.9.3.1) 



Enter selection ntimber (*1'..*5'), 
help: 



' continue ' , * previous ' , ' cancel ' t or ^ ? ' for 



Figure 63. Installation Media Identification Menu - Network 

A single package, OS/MP 4.1C Full-Install Optional Software, is included on the 
OS/MP 4.1C distribution tape. The following display shown in Figure 64 appears; 
the values shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 

^Enter number of package to examine ( ^ 1 ' » , ' 1 M / ^cancel' , 
'install', or '?* for help: 1 

Should the OS/MP 4 . IC Full-Install Optional Software 
l ^ package be inst alled (*yes', 'no', ''^C, or '?' for help)? 

The Should the OS/MP 4 . IC Full-Install Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 



After replying yes, the customization menu will appear as shown in Figure 65. 
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Package Selection 

Mandatory Software Will Be Installed 

Package Name Size {KB) Install 

1) OS/HP 4.ac Full-Install Optional Software 34832 n 



Enter niimber of package to examine {*l'..'l'), ^cancel', ^install', or *?' 
for help: 



Figure 64. Package Selection Menu 

* * * NOTE * * * 

Figure 65 is only an example. The free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule' s name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sun window. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 
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Customization 


of Soibourne OS/MP 4.1C Optional 


Software 






Software 


Modules 




Module 


Size (KB) 


Install 


Directory 


Free (KB) 


1) DEBUGGING 


2888 


y 


/usr 


S8695 


2) GAMES 


3136 


y 


/usr 


- ,58695 


3) MUmiMA 


7440 


y 


/usr 


58695 


4) NETWORKING 


1072 


y 


/usr 


58695 - 


5) PLOT 


1784 


y 


/usr 


58695 


6} SECURITY 


312 


y 


/usr 


58695 ', 


7) SV_PROG 


1848 


y 


/usr 


58695 ; 


8) SV_USER 


2320 


y 


/usr 


58695 


9) SYSTEM_V 


4032 


y 


/usr 


58695 


10) TEXT 


720 


y 


/usr 


58695, , 


11) VERSATEC 


5960 


y 


/usr 


58695 


12) UUCP 


608 


y 


/usr 


' 58695'; 


13) RFS 


912 


y 


/usr 


58695 


14) SHLIB 


1376 


y 


/usr 


58695^ 


15) TLI 


48 


y 


/usr 


58695 , 



Enter number of module to modify { *1* , , *15' ) , ^continue' 
help: 



'aborts or ^?' for. 



Figure 65. Package Selection Customization Menu 

NETWORKING ■ network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
SA^P database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG)andgraph(lG). 

SECURITY -C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - SunView program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 
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SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 



TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC " Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

* • * NOTE * * • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter number of module to modify {'!'..* 15')/ ' continue % 
abort * , or ' ? ' for help : 11 

The VERSATEC menu entry is highlighted, and: 

'^Modifying the Versatec printer support module ~^ 

Should the VERSATEC module be installed {'yes', 'no', ^Ct 
^OT *?' for help)? no ^ 

Figure 66 shows the updated display: 

* * • NOTE • • • 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 66. 
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Customization of Solbourne OS/MP 4.1C Optioni&l Software 



Module 


Size (KB) 


1 


DEBUGGING 


2888 


2 


GAMES 


3136 


3 


MANUAL 


7440 


4 


NETWORKING 


1072 


5 


PLOT 


1784 


6 


SECURITY 


312 


7 


SV_PROG 


1848 


8 


SV„USER 


2320 


9 


SYSTEM^V 


4032 


10 


TEXT 


720 


11 


VERSATEC 


5960 


12 


UUCP 


608 


13 


RFS 


912 


14 


SHLIB 


1376 


15 


TLI 


48 



Software 


Modules 




Install 


Directory 


Free (Kb) 


y 


/usr 


64655 ' 


y 


/usr 


64655 


y 


/usr 


^ =64655- 


y 


/usr ' 


64655 


y 


/usr 


- 64655 


y 


/uer 


64555' 


y 


/usr - 


64655 


y 


/usr 


■ '64655 


y 


/usr 


64655 


y 


/usr 


64655 


y 


/usr 


,64655 , 


y 


', /usr 


64655 


y 


/usr . 


- 64655 


y 


/usr 


64655 



Enter number of module to modify Ol* . • '15' ) / ^continue' 
help: 



'abort' > or ^?' for 



Figure 66. Package Selection Menu - Deletion of Versatec Module 
To install the GAMES module in /fun (on the root partition): 



Enter number of module to modify {*!'..* 13'), 'continue', 
'abort', or *?' for help: 2 



The GAMES menu entry is highlighted, and: 



f^ Modifying the games and demonstration programs module 

Should the GAMES module be installed {*yes', ^no', ''C, or 
'?' for help)? yes 

Install GAMES in what directory? /fun 

/fun does not exist. Create it during installation {'yes', 
'no', -^C, or '?' for help)? yes 

'•h,. ■ *- 

The menu is updated to reflect the change, as shown in Figure 67. 

• • * NOTE • * • 

The free space for Aisr changes, and a completely new size (for /lun) is also dis- 
played as shown in Figure 67. 

If you decide to discard all changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 
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Customization of Solboume OS/MP 4.1C Optional Software 



Module 


Size (KB) 


1) 


DEBUGGING 


2888 


2) 


GAMES 


3136 


3) 


MANUAL 


7440 


4} 


NETWORKING 


1072 


5} 


PLOT 


1784 


6) 


SECURITY 


312 


7) 


SV_PROG 


1848 


8) 


SV_USER 


2320 


9) 


SYSTEM_V 


4032 


10) 


TEXT 


720 


11) 


VERSATEC 


5960 


12) 


UUCP 


608 


13) 


RFS 


912 


14) 


SHLIB 


1376 


15) 


TLI 


48 



Software Modules 




Install 


Directory 


Free (KB) 


y 


/usr 


67791 


y 


/fun 


4579 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


n 






y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 


y 


/usr 


67791 



Enter number of module to modify {^1',.'15'), ^continue', ^aborts or '?' for 
help: 



Figure 67. Package Selection Menu - Install Games module to /fun 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 68. 

The actual installation begins at this point. The steps taken during the installation 
are: 

1 . create filesystems (root(/), /usr, possibly /var or /tmp 

2. install mandatory root files 

3. install mandatory kvm files 

4. install mandatory usr files 

5. install optional software 

When installation has finished, it gives the following message: 

^Optional Software Installation Succeeded ^ 

Press any character to continue , 

V 1 , y 

The next display gives the values of the previous and new ROM variables DE- 
FAULTROOT, DEFAULTSWAP (if they have changed), and asks if you want 
to update the variables, as shown in Figure 69. 
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Package Selection 
Mandatory Software Will Be Installed 
Package Name Size (KB) Install 

1) OS/MP 4.1C Full-Install Optional Software 34832 y 



Enter number of package to examine pl',.'l'), 'cancel', install'/ or '? 
for help: install 



Figure 68. Package Selection Menu 



Ready to Update ROM Variable 

Previous DEFAULTROOT=sd . si { , , ) , New DEFAULTROOT=iSd . si { , 2 , ) 

DO you want to go ahead and update the ROM {'yes', *no', ""C, or *?' for help)? 



Figure 69. Update ROM Variable 
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• • • NOTE * • * 

Before you say 'yes ', make sure that all the previous settings of these variables are 
recorded so that you can later reboot from the old version of the system if neces- 
sary. If you choose not to update the ROM variables, make sure that you record the 
new values and use them to reboot the newly installed system at a later time. 

reinst_sys then performs the final system setup, and completes. The new system's 
filesystems are currently mounted under the/etc/sys_conf/reinst_sys/root directo- 
ry. For example, the new version of the /var directory is mounted at /etc/sys_con- 
f/reinst_sys/root/var. 

At this point, the newly installed system is ready to boot. However, you may want 
to finish the installation by creating or editing such files as /etc/rc.local, auto- 
mounter maps, /etc/printcap, the /var/spool directories, NIS/YP maps, or any oth- 
er files local to your system. If you have comments in your/etc/fstab file, they will 
not exist in the new /etc/fstab file, so you may want to edit this file. 

• * * NOTE • * * 

If you installed the new system on a disk that is not recognized by a OS/MP 4.1 C 
generic kernel, then you must reconfigure the kernel before rebooting. 

You may also wish to create a customized kernel on the new system, so that hard- 
ware such as the channel board and VSCSI devices will be recognized. If you 
would rather wait until after rebooting the new system to configure your kemel, 
you should edit the new /etc/fstab file and comment out any partitions which are 
on disks not visible to the generic OS/MP 4.1C kemel. 

After you have completed customizing the new installation, reboot your machine, 
using the new ROM variables. 

If you used the -a option to upgrade to a different architecture, then after custom- 
izing the new installation, halt the machine and tum off the power. Replace the old 
CPUs with the new CPUs, power up and boot your machine using the new ROM 
variables. 
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Before Installing... 



Installing... 



Installing OS/MP 4. IC 
on a Dataless Client 



This chapter describes how to install OS/MP 4.1C on a Dataless Client. 

A dataless client is a machine whose /usr files are NFS-mounted from another ma- 
chine (the "server") but whose root partition is on a local disk. 

* • * NOTE • • * 

Before installing a dataless client, you must have already installed the server. On 
the server, you must also have run config_server for this client's architecture. Re- 
fer to Installing OS/MP 4.1C on a Server for details. 

* * * CAUTION * * * 

Perform a full backup before installing OS/MP 4.1C. A complete installation 
will overwrite all information on the disk partitions specified for the root (/), 
swap, /var, and /tmp Hlesystems. 

Before installing the release tape, you must clean the tape drive on the host 
machine. Failure to do so may damage the release tape. 



Starting in OS/MP 4. IC, the preinstall utility is available to help determine which 
system files should be restored or merged from backup, preinstall shows which 
files in system directories were modified after you last installed the OS version 
you're currently running. 

If you do not want to use preinstall, skip to the section Loading the Ramdisk be- 
low. 



Installing preinstall. 



Because preinstall was not included in versions of OS/MP prior to 4.1C, it is nec- 
essary to install it before proceeding to install OS/MP 4.1C. 
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When using a local tape drive, install preinstall using the following commands: 






When using a remote tape drive, the system name needs to be in the tapehos ts 
Arhosts file, Install preinstall using the following commands: 



illlililililjIillllH^^^^ 


||||:||j|:;|||i||:|;j||:!|||:| 


iiiil\ 


IllllilliiiiiiiiiiliiJIi:!^^^^^^^^^^^^^^^ 


||||:||||= 




|i||||||i||||j||||||i^ 


■^lillllllllllJIB 


'iiiip 



In this example, you should replace tapehos t with the actual name of your tape 
host machine, 

• • • NOTE • • • 

Some older versions of SunOS do not support the 'asf request for mt. If this is the 
case for your tape host, first substitute *rew'for 'asf 5' in the above example, and 
then re-execute mt with fsfS' instead of *rew'. 

When using a local CD-ROM drive, install preinstall using the following com- 
mands; 

ii;;fliiii|ilcijiii'iiijii^.^ 
IllllliililJ^ 
i||g||||in^ 

jliiiiiillliiii^^ 

When installing over the network, or when using a remote CD-ROM drive, create 
a mount point directory (if one doesn't exist), and mount the CD-ROM drive on the 
remote machine, referred to here as nethosts, as follows: 

|^riethost# itskdir "/cdrom- ' . ' ' ' 

V ^nethost# motmt /dev/srO /cdrom , 

Install preinstall using the following commands: 

ff cd /tisr/etc ' 

V# rsh -n nethoBt dd i£«>/cd3raj]i/a?ools.feay l?8«8k | tar aepBf ^^ 

In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 
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Using preinstall 

After preinstall has been installed, it is located in /usr/etc. The usage of preinstall 
is as follows: 



/usr/etc/preinstall [ -1 ] [ -c mmddhhmm[yy] ] 

The preinstall command is used to look for files that should be saved prior to doing 
a full install of a new version of OS/MP. It looks on the system partitions (root(/), 
/usr, and /var) for files which have been touched after the date of the last full install 
of OS/MP (or, if given a cutoff date, files touched after that date). 

preinstall is normally used just before installing a new version of OS/MP to deter- 
mine what system-related files should be backed up. Then, after installing the new 
version of OS/MP, you can merge or restore these files into the newly-installed sys- 
tem. 

Some files, such as /etc/fstab, can typically be re-used without modification. Oth- 
ers, such as kernel configuration files in /usr/kvm/sys/*/conf, must be hand- 
merged into the new version of the OS with careful consideration of how the new 
OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. 
These files are normally updated by system operation and do not need to be backed 
up. Examples of excluded files are: /etc/mtab, the /var/sadm accounting files, the 
/tmp_mnt automounter directories, and patched kernel object files in 
/usr/kvni/sys/*/OB J. By default, the cutoff date used is the modification date of 
the file /etc/sys_con^system-configured, which is touched the first time you boot 
a new version of the OS after a full install. You may want to use some other cutoff 
date with the -c option if the current OS was installed in some non-standard way. 

By default, the files and directories newer than the cutoff are listed to standard out- 
put by name, one per line. By using the -1 option, the output is in long form (as from 
the -Is option to find), showing the type, date, and size of each file. 

The following options are accepted by preinstall: 

□ The -1 option presents the output in long form, showing inode number, size in 
kilobytes (1024 bytes), protection mode, number of hard links, user, group, 
size in bytes, and modification time. If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic 
link the pathname of the linked-to file is printed preceded by '- >' . The format 
is identical to that of find -Is. 

O The -c option specifies to use the given cutoff date to decide which files to 
print, rather than the date of the file /etc/sys_conf/system-configured. The 
cutoff date format is -c mmddhhmm[yy], with month, day, hour, minute, and 
optional year in numeric form. This is the same format as for/usr/5bin/touch. 

After configuring the server for a dataless client, loading the ramdisk image is your 
next step in a diskful installation. The ramdisk image is a special UNIX operating 
system kernel with a built-in ramdisk that contains the installation software. The 
command to load the ramdisk depends on the type of system. Follow the instruc- 
tions for your system type. 
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Installing on a SeriesS, 
SeriesSE, or Series6: 



Loading the Ramdisk 

The following explains four different methods of loading the ramdisk. After you 
have loaded the ramdisk continue on to the Dataless Installation section. 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

Loading the Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



|j|ll||j||||:||||^^^^^ 



I 



The system asks if you want to re-install if INSTALLED is not 0. 

To load the ramdisk on SeriesS or 5E systems using a local tape drive, enter the fol- 
lowing boot command: 



liiiiiiiiJiiiiiiiiiw 



I 



To load the ramdisk on Series6 systems using a local tape drive, enter the following 
boot command: 



('rOM> boot St, si (^ Tape JZ?/ 3) 



) 



The variable Tape JD shown in the command should be replaced with the SCSI ID 
of the tape drive to be used. For stO, use 4; for stl, use 5. 

The bootROM copies the ramdisk image into memory and boots it: 



/^Boot: St. si {,4, 3) 
Entry: 0xf£060000 
Size: Oxl0e000+0x56afb8+0xadc40 



The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following exam- 
ple, must be on the same network as the system being installed, referred to as ham- 
ster in the following example. For example, with a class C network, the first three 
numbers in the Internet addresses of the two machines must be the same, such as 
192.1.3.42 and 192.1.3.17. Also, hamster must be listed in /etc/hosts, or in the NI- 
SA^P hosts database, and/.rhosts on tapehost. In addition, the ethemet address 
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must be in the ethers database. The tapehos t must also be running the rarpd(8) 
daemon.The ramdisk must be extracted from the OS/MP 4.1C distribution tape 
onto a disk on tapehost. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf. A line similar to the one below should 
be in the file: 



tftp dgram udp wait root /usr/etc/in,tftpd in.tftpd -s 
/tftpboot 

If the line starts with a #, remove the #. 

If a -s appears after the last in . tf tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 



(^tapehost # pa ax | egrep inatd 

249 ? I 0:01 inetd 

541 p3 R 0:00 egrep inetd 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(^ tapehost # kill -HUP pid . ) 

* * • NOTE • • • 

In the following example the install kernel will be named /var/tmp/install. The ac- 
tual name of the file is not important, as long as it is used consistently here and in 
the example on the next page. Also note that thefilesystem must have enough space 
to hold the install kernel. 

In the mt command below, replace the variable X with one of the following values, 
depending on the type of system: 

Table 22. 



System 


Value of X 


SeriesS and 5e 


2 


Series6 


3 
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Put the distribution tape into the tapehost drive and execute the following com- 
mands. For Exabyte tape drives, use bs=1024 instead of bs=512 in the dd com- 
mand shown below. 



jill|iiii|j||p^^ 
j|||Bi|i||i|ji|l||il|i|i||^ 

Enter the following boot command: 

laigieiiiiiiiiiMBiiiiaiiBw^^ 

In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the system's Intemet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

lllllllljiiglllli^^ 

The system will ask if you want to re-install if INSTALLED is not 0. 
Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

* * * NOTE • * * 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
3.5 or higher. 

In the two boot commands below, replace the variable X with one of the following 
values, depending on the type of system. 

Table 23. 



System 


Value of X 


SeriesS and 5E 


5 


Series6 


6 



To load the ramdisk on SeriesS, 5E, or 6 systems, using a local CD-ROM drive, 
enter a boot command of the following form: 

C ROM|||i|i|||||| « a X ( f g||iiii|t aX 1 * Ser ieax j 
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The bootROM copies the ramdisk image into memory and boots it: 

/^Boot : sd.si (, 6/)/Instali.SeriesX 

Entry: Qxf£060000 
l ^Size: 0xl6Q000+0x748e8+0x660c8 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4.1C contained on a remote disk 
accessed over the network. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



||i|IBii|iiiiHllli 



The system will ask if you want to re-install if INSTALLED is not 0. 

if you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4. IC CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 

'^diskhost# mkdir /cdrom " "" 
^dis.ichost# moimt /dev/srO /cdrom 

The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
192.1.3.17. Also, the local machine must be listed in /etc/hosts, or in the NIS/YP 
hosts database and the ethemet address must be in /etc/ethers, or in the NIS/YP 
ethers database. In addition, diskhost must have the rarpd(8) daemon running. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost. Examine the file/etc/inetd.conf. A line similar to the one 
below should be in the file: 

tftp dgram udp wait root /usr/etc/in. tf tpd in.tftpd -s 
/tftpboot 
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If the line starts with a #, remove the #. 

If a - s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, metd(8) must be told to re-read the configu- 
ration file: 

^diskhost # ps ax j egrep Inetd 

249 ? I 0:01 inetd 

541 p3 R 0:00 egrep inetd 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 



|jl|iii||lll|^^^^ 



I 



In the boot command below, replace the variable X with one of the following val- 
ues, depending on the type of system 

Table 24. 



System 


Value of X 


SeriesS and 5E 


5 


Series 6 


6 



Enter the following boot command: 



( ^ROM> b tftp,€ti(y ,host:number)/C(arom/xnetalX,SerieeX ) 

The bootROM copies the ramdisk image into memory and boots it: 

^Boot ; tf tp,ex ( , fhostnumber) /cdrom/ Install, SeriesX 

Entry: 0xff060000 
^Size: 0xl0e0QQ+0x56a£b8"h0xadc40 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 
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Dataless Installation 

After Booting Ramdisk 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 

A) 610 "" ™__---^-^^^--^_-__-— ___™-™-_^ 

2) ansi 

3) hp 

4) sun 

5) tvi912 

6) vtlOO 

7) wyseSO 
What type of terminal are you using ( ' 1 ' , . ' 7 ' ) ? 

If a frame-buffer is being used as the console, select the 4, the sun terminal type. 

rwhat type of terminal' are you using {'1'..'7')? 4 ~) 

If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 

^THIS SYSTEM IS ALREADY INSTALLED ' 



Do you want to re-install the system {'yes', 'noS or *?' 
■for help) ? 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-install the mandatory system software, or 
no to continue the installation without re-installing it. 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



Ramdisk 

1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 

Enter number of function to execute ('l',.'5S or ^?' for 
help) : 

The provided functions are described below: 

Change Disk Partitioning - Allows the changing of the sizes of disk partitions, 
and what those partitions are to be used for (filesystem, swap, or unused). Refer to 
the Changing Disk Partitions Section for details on changing disk partitions. 

• * * NOTE * * • 

If changes are going to be made to the disk partitions on which OS/MP 4.1C will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. See ' 'Software Installation from 
the Ramdisk," for more information. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must 
then select Change Disk Partitioning before attempting to Install 
Software. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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Help may be requested at any ramdisk prompt by entering a question mark by itself. 
Table 25 shows edit commands available when entering text in response to 
prompts: 



Table 25. Input Editing Commands 



Character 


Interpretation 


backspace (^U) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input Une 


'^R 


redisplay input line 


AW 


delete input up to 7' or whitespace 


^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return (^M). 


end input 


newline (^^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . " . This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with "System error" or "Internal error" and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



^# -^jfiitty Sana* J 

# cd / 

# rm "f /core 

# inst_sys 



V 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix that problem). In the event of a fatal error during software instal- 
lation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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For a dataless client installation, there are three informational menus: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

D Dataless Install Identification - specifies the dataless client's name and the 
servers Internet address. 

□ Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always retums to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always retums to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. The /usr files should have already been installed on the server. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Changing an entry at the Standard Filesystem Definition 

The following steps assign the /usr filesystem to rootbeer:/export/exec/Series5., 
rather than using the default of /usr being a subdirectory of the root filesystem. 

To modify the /usr filesystem, enter the number 3. 

Enter nmnber of filesystem to change (*1'..*5')/ 
continues ^previous \ ^cancel ^ or ''7' for help: 3 

The usr menu will be highlighted, and the system will request a disk partition. The 
format is host:path, where host is the name of the server from which the /usr files 
will be used, path is I exportlQ.xQd architecture (which was created by running con- 
fig_server) where export is your export directory, and architecture is the architec- 
ture of your dataless client. Assign it to rootbeer:/export/exec/Series5. 

If you wish to use a directory other than /export, set the environment variable EX- 
PORT_DIR to the directory that you desire 

The new arrangement is displayed as shown in Figure 70. 
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The following steps assign the/var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 70 shown below, the notation "(required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 



standard Filesystem Definition 

1) root on sdOa (required) 

2) swap on sdOb (required) 

3) /usr on rootbeer; /export/exec /SeriesS (required) 

4) /var on root partition 

5) /trap on root partition 









Disk Partitions (sizes 


in MB) 








(a) 


(h) 


(c) (d) (e) 


^f) 


{g> 


<h) 


sdO: 


8.4 


32.4 


191.1 9.3 





141.1 





sdl: 


8.4 


32.7 


190.9 9.6 


, 


140.8 


^-^ 



Enter number of filesystem to change (^1'..'5'), 'continue'/ * previous', 
'cancel', or '?' for help: 



Figure 70. Sample Standard Filesystem Definition Menu for Dataless Clients 

To modify the /var filesystem, enter the number 4. 

Enter number of filesystem to change {'l'..*5'); 
'continues ' previous ', ^cancel' or '?' for help: 4 

The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 

Enter name of disk partition or host:path for /var 
filesystem^ 'none', ■^C, or'?' for help: sdOd 

The new arrangement is displayed as shown in Figure 71. 
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Standard Filesystem Definition 

1) root on sdOa (required) 

2} swap on sdOb (required) 

3) /usr on rootbeer: /export/exec/Series5 (required) 

4) /var on sdOd 

5) /tmp on root partition 





(a) 


(b) 


sdO: 


8.4 


32.4 


sdl: 


8.4 


32.7 



Disk Partitions (sizes in MB) 

(c) (d) (e) (f) (g) 

191.1 9.3 — — 141.1 

190.9 9.6 — — 140.8 



(h) 



Enter number of filesystem to change ('I'.-'S'), 'continue', 'previous', 
'cancel', or '?' for help: 



Figure 71. Modified Standard Filesystem Definition Menu for Dataless Clients 

Once all changes for the standard filesy stems have been made, enter continue: 



/'Enter number of filesystem to change ('1'..'5'), 

V^ 'continues ' previous \ 'cancel', or ^?' for help; continue, 



Next you are asked to verify the /usr partition. If the value is correct, enter yes to 
proceed to the Dataless Install Identification Menu: 

f^Is rootbeer : /export/exec/Series5 the correct host: path for 
the /usr partition? 

('yesS 'no', '^C, or '?' for help): yes _ 

The Dataless Install Identification Menu 

The Dataless Install Identification Menu is a new menu that only appears when the 
/usr partition in the Standard Filesystem Definition Menu specifies that the install 
will be dataless. 

This menu was added so that it is no longer necessary to hand modify the /etc/hosts 
and /etc/hostname.eiO files. In releases prior to OS/MP 4.1C, at the completion of 
the dataless installation, the user had to exit to a Bourne Shell, and modify these 
files by hand. 



Figure 72 shows the Dataless Install Identification Menu. 
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Dataless Install Identification Menu 

1) Client Machine Name - <undefined> 

2) Internet address for rootbeer ^ <undefined> 



Enter selection number { ' 1 ' . , ''2 ' ) , ' continue' , ^previous ' 
'cancel'/ or '?' for help: 



Figure 72. Dataless Install Identification Menu for Dataless Clients 

The Client Machine Name is simply the name of the Dataless Client that you are 
currently installing. 

The Internet address is the address of the server from which the /usr files will be 
used. In this case the server is rootbeer. 

Both of these variables must be set before continuing. After these values have been 
entered correctly, enter continue. Next you are asked to verify the values en- 
tered. If the values are correct, enter yes to proceed to the Media Identification 
Menu. 

Installation Media Identification Menu 

The Media Identification Menu describes which type of installation media will be 
used during the installation and where it is located. On SeriesS, SeriesSE, and 
Series6 systems, the default is to install from a local tape drive, even if no such 
drive exists. Therefore, changing the settings on a non-Series S4000 machines 
probably will be necessary. 

Figure 73 shows the Media Identification Menu. 

Installing from a Tape Drive 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to local - 
host. The Installation media type must also be set to Tape. 

Installing from a remote tape drive requires that all the fields be s^t: 
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Installation Media Identification 

1) installation media type » Tape 

2) Tape drive =f /dev/nrstO 

3) Local Internet address = 0.0.0.0 {required for remote tape) 

4) Network broadcast mask ~ OxffffOOOO (required £or remote tape) 

5) Tape host ~ localhost (127.0.0.1) 



Enter selection number {^1'..'5'). ^continue', 'previous'^ 'cancel', or '?'for 
help: 



Figure 73. Installation Media Identification Menu - Local Tapehost 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host' s /.rhosts file. Check /etc/hosts or the NIS A^P 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 74 shows the Media Identification menu of a system that was booted from 
a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 



Installing OS/MP 4.1C on a Dataless Client 227 



Installation Media Identification 

1) Installation media type = Tape 

2) Tape drive ^ /de/nrstO 

3) Local Internet address = 192.9.3.4 {required for remote tape) 

4) Network broadcast mask = OxffffffOO {required for remote tape) 

5) Tape host » tape-n-boot-serv {192.9.3.1) 



Enter selection number (^1' . ,'•5') , ^continue', 'previous'/ 'cancel', or '?'for 
help: 



Figure 74. Installation Media Identification Menu - Remote tapehost 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 75 shows the Installation media type menu 
with the CD-ROM parameters set to install from CD-ROM. 

Network and remote CD-ROM Installations 

Figure 76 shows the Installation media type menu with the Network parameters set 
to install from the network or a remote CD-ROM, Installations of this type require 
that all the fields be set as follows: 

Installation media type must be set to Network 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /cdrom, then the installation path 
is simply /cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host' s /.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 
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Installation Media Identification 

1) Installation media type - CO-ROM 

2) CD drive = /dev/srO 

3) Local Internet address = 0-0.0.0 {required for remote tape) 

4) Network broadcast mask - OxffffOOOO (required for remote tape) 

5) CD host ~ localhost (127.0.0.1) 



Enter selection number {^l'..'*5'), * continue', 'previous', 'Cancel', or '?'for 
help: 



Figure 75. Installation Media Identification Menu - Local CD-ROM 



Installation Media Identification 

1) Installation media type ~ Network 

2) Installation directory - /cdrom 

3) Local Internet address = 192.9.3.4 (required for remote tape) 

4) Network broadcast mask - OxffffOOOO (required for remote tape) 

5) Network host = ginger (192.9.3.1) 



Enter selection number ('!'.. '5'), 'continue', 'previous', 'cancel', or '?'for 
help: 



Figure 76. Installation Media Identification Menu -Remote CD-ROM 
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The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the remote CD-ROM, 
and it's Internet address. 

For a remote CD-ROM install, the nethost must have /cdrom in it's /etc/ex- 
ports file, and must export it. Also, the rpc.mountd(8), nfsd(8), and rarpd(8) dae- 
mons must be running on nethost. 

When the details of the media have been entered correctly, enter continue. 

Root Files Installation 

Next, you are asked if you want to install just the mandatory root files. This is asked 
as a confirmation before starting the installation: 

Install only mandatory root files {*yesS 'no% ^C, or '?^ 
for help) ? 

After entering yes, the installation is performed. When it completes, you will be 
returned to the ramdisk menu. Reboot the system. 

The steps taken during the installation are: 

1 . extract miniusr. This contains the installation software, as well as enabling 
swapping. 

2. create filesystems (root(/), possibly /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

When installation has finished, the ramdisk menu is displayed (see Figure 77). If 
the installation failed, call Customer Support. 

Rebooting from the Ramdisk 

When the Tape Change selection is displayed, type continue . 

After a successful installation, start the UNIX operating system by rebooting as 
shown in Figure 78. 

Enter number of function to execute ('r..'5', or '?' for help): 4 

At the Reboot System menu select Boot Unix: 

(^ Enter selection number {^1' , .^"i' ) or '?^ for help: 1 ^ 
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Ramdisk 



1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Enter number of function to execute <'1'..*5', or '?' for help): 4 



Figure 77. Ramdisk Menu 



Reboot System 



1} Boot Unix 

2) Boot on ramdisk 

3) Return to Main Menu 



Enter selection number {*1'..'3') or ^?' for help: 1 



Figure 78. Reboot System Menu 
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After selecting 1, there is a short pause, and then: 

'^Automatic boot enabled. Type Control ~C to abort 
ROM> boot 

Boot: sd.si (0, 0, 0) /vmunix 
Entry: 0xff060000 
Size: 0xl60000+0x748e8+0x660c8 



OS/MP 4.1C_Export (GENERIC/ root) #0; Tue Feb 1 15:52:44 

1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 

Solbourne Computer, Inc. 

V. . - / 

Now you must specify the system configuration information must be specified. 

Disabling tfip 

If the ramdisk was loaded from a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system from which the tape 
was read. 

First, comment out the line, as shown below, in /etc/inetd.conf. 



#tftp dgram udp wait root /usr/etc/in. tftpd in.tftpd 
/tftpboot 



Next, determine the process ID of inetd(8): 



^tapehost# ps ax | egrap inetd 

249 ? X 0:01 inetd 

541 p3 R 0:00 egrep inetd 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249, 

Last, signal inetd to re-read the configuration file: 



iJHiliilJJipiiillipi^^ 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4.1C_Export (GENERIC /root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas: done. 

This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix. 

What is this system's name (default - * standalone' ) t 
habitrail<Rdtiim> 

What is its Internet address (0 for none, ■ default = 
192.9.3.4)? <Retum> 

What is the network broadcast mask (default - Oxff f f f fOO) ? 
<Rettirn> 

What is the NIS domain name (^none' for none, default = 
* none ' ) ? Rodent . COM<Rettirn> 

What directory should be used for automatic savecore files 
{'none' for none, default = Vvar/crash/habitrail ' ) ? 
<Retum> 



* • * NOTE * • • 
Using the default 'none' for the NIS domain name disables the NIS/YP services. 
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Time zone 


choices are: 








Australia/ 


GMT+11 


GMT- 3 


GMT 6 


Mideast/ 


Brazil/ 


GMT+i2 


GMT-4 


GMT7 


NZ 


CET 


GMT+13 


GMT- 5 


GMT 8 


Navajo 


CST6CDT 


GMT+2 


GMT -6 


GMT9 


PRC 


Canada/ 


GMT+3 


GMT-7 


Greenwich 


PST8PDT 


Chile/ 


GMT+4 


GMT- 8 


HST 


Poland 


Cuba 


GMT+5 


GMT- 9 


Hongkong 


ROC 


EET 


GMT+6 


GMTO 


Iceland 


ROK 


EST 


GMT+7 


GMTl 


Iran 


Singapore 


ESTSEDT 


GMT+8 


GMTIO 


Israel 


Turkey 


Egypt 


GMT+9 


GMTll 


Jamaica 


UCT 


Factory 


GMT-0 


GMTl 2 


Japan 


US/ 


GB~Eire 


GMT-1 


GMTl 3 


Libya 


UTC 


GMT 


GMT- 10 


GMT2 


MET 


Universal 


GMT+0 


GMT- 11 


GMT3 


MST 


W-SU 


GET+l 


GMT- 12 


GMT4 


MST7MDT 


WET 


GMT+10 


GMT- 2 


GMT5 


Mexico/ 


Zulu 



( V indicates time zone prefixes) 



Enter time zone (default - 'US/MountainM : <Retum> 

What is today's date (mm/dd/yyyy, default = 2/1/1994)? <Retum> 
What time is it {24-hour hh:mra, default = 16:55)? <Return> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



habi trail 

192.9.3.4 

OxffffffOO 

Rodent . COM 

/var/crash/habi trail 

US/Mountain 

2/1/1994 

16:55 



Are these correct ('yes' or 'no')? 
yes 

Setting netmask of eiO to 255 ♦255 ♦255.0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on habitrail. 

New password: 

Retype new password: 

Continuing boot 

starting rpc and net services: portmap [ 



J 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button.. 

* * * NOTE * * * 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 

(iS^Hliiilii^^ 

If the system booted successfully originally, you may instead log in as root: 

(li|S5Hil|l|||iii|||f 

In either case, if a file exists that tells the system it has been configured, remove it: 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 



(# exit 


) 


Otherwise, use fastboot: 


r# /etc/ fastboot 


1 



The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing on a Series S4000 



Loading the Ramdisk 

The following explains four different methods of loading the ramdisk. After you 
have loaded the ramdisk continue on to the Dataless Installation section. 

Loading the Ramdisk via a Local Tape Drive 

Tum the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



iSBiliiiililip 



I 



The system asks if you want to re-install if INSTALLED is not 0. 

To load the ramdisk on Series S4000 systems using a local tape drive, enter a boot 
command in the following form: 



> install 

Which type of device do you wish to install from: 

1) Tape 

2 ) Network 
Enter device type: 1 
You have the following tape drives ♦ Please choose one : 

1) At Target4, drive name: ARCHIVE VIPER 150 21247-005 

2) At Targets, drive name: EXABYTE EXB--8200 251K 
Enter device number: 1 

The bootROM copies the ramdisk image into memory and boots it: 



/^Boot: st.si(,4,4) ~~~ 

Entry; OxfdOSOOOO 
Size; 0xec000+0x53ab28+0x42ab8 



The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. Proceed to the Dataless 
Installation section 
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Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following exam- 
ple, must be on the same network as the system being installed, referred to as ham- 
ster in the following example. For example, with a class C network, the first three 
numbers in the Internet addresses of the two machines must be the same, such as 
192.1.3.4 and 192.1.3.1. Also, hamster must be listed in /etc/hosts, or in the NIS/- 
YP hosts database, and Arhosts on tapehost. In addition, the ethemet address 
must be in the ethers database. The tapehost must also be running the rarpd(8) 
daemon.The ramdisk must be extracted from the OS/MP 4.1C distribution tape 
onto a disk on tapehost. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf. A line similar to the one below should 
be in the file: 

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -s 
/tftpboot 

If the line starts with a #, remove the #. 

If a - s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp as shown above. Approximately 6 
MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

liBiiiBiilii^^ 
i^l|iiiiiiiiiiiiiii|;|H^ 
llijijlllii^^^^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

* * * NOTE * • * 

In the following example the install kernel will be named /var/tmp/install. The ac- 
tual name of the file is not important, so long as it is used consistently here and in 
the example on the next page.Also note that the filesy stem must have enough space 
to hold the install kernel. 
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Put the distribution tape into the drive and execute the following commands. For 
Exabyte tape drives, use bs=1024 instead of bs=512 in the dd command shown be- 
low. 

/^tapehost # cd /var/tmp 

tapehost # mt -f /dev/nrstO asf 4 
I tapehost # dd ifs=/dev/nrstO of-install bss=512 

Enter the following boot command:. 

/^ROM> install 
Which type of device do you wish to install from: 

1 ) Tape 

2 ) Network 

Enter device type; 2 

Enter internet address of this system (defaultssa.b.c.d) : 
192*9.3.4 

Enter internet address of remote tape system 
(default=a.b.c»d) ; 

192.9.3,1 

Enter name of file to boot {default-/usr/boot/mianix.S4000) 
/var/tmp/ install 

Using IP address 192.9.3.4 ^ C0090304 
Server at IP address 192.9.3.1 = C0090301 
Boot: tftp.eiC, 1^ 1) /var/tmp/install 
Entry: OxfdOSOOOO 
^Size: 0xec000+0x53ab28+0x42ab8 

In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the system's Internet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

iililiiiiiliililiiiill^ 

The system will ask if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4.1C CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 

|ii||l|j|g|||j||j 

The bootROM copies the ramdisk image into memory and boots it: 

^Boot: sd*si(, 6, ) /Install *S4000 

Entry: OxfdOSOOOO 
^Size; 0xec0004-0x53ab28H'0x42ab8 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4.1C contained on a remote disk 
accessed over the network. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

illllllilliil^ 

The system will ask if you want to re-install if INSTALLED is not 0. 

If you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4.1C CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 

/^diskhost# inkdir /cdrom 

I diskhost* mount /dev/srO /cdrom 
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The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
192.1.3.17. Also, the local machine must be listed in /etc/hosts, or in the NIS/YP 
hosts database the ethemet address must be in /etc/ethers, or in the NISA^P ethers 
database. In addition, diskhost must have the rarpd(8) daemon running. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost. Examine the file/etc/inetd.conf. A line similar to the one 
below should be in the file: 



iiipiiiiiHHiili 
iiHIiiliiiiiiiiiiiiiiiii^^ 



If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 



'^diskhost # ps euc I egrep inetd 

249 ? I Old inetd 
^ 541 p3 R 0:00 egrep inetd 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 



||i|iiii|iij||i|ii|^^^^ 



Enter the following boot command: 

(R0K> h tftp.eiCi2ostnLmiber)/cdrom/lnstall.S4000 ^ 

The bootROM copies the ramdisk image into memory and boots it: 

^Boot: tftp.ei(, , hostnumber) /cdrom/ Install. S4000 

Entry: OxfdOSOOOO 
\ ^Si2e: 0xec000+0x53ab28-f0x42ab8 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 
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Dataless Installation 

After Booting Ramdisk 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 

^1) 610 ' ^^ ~" ~™ — — 

2) ansi 

3) hp 

4) sun 

5) tvi9l2 

6) vtlOO 

7) wyseSO 
v^What type of terminal are you using j'^l' . . ''7 ' )? 



If you are using a frame-buffer as the console, select the 4, the sun terminal type. 



Twhat type of terminal are you using ( ^1' . . v? ^ ) *?. 4 



; 



If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



/^THIS SYSTEM IS ALREADY INSTALLED 



Do you want to re-install the system (^yes', *no', or '?' 
for help) ? J 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-install the mandatory system software, or 
no to continue the installation without re-installing it. 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 

/^Raindi sk 

1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 

Enter number of function to execute (^1'..''5', or *?' for 
I help) ; 

The provided functions are described below: 

Change Disk Partitioning - Allows the changing of the sizes of disk partitions, 
and what those partitions are to be used for (filesystem, swap, or unused). Refer to 
the Changing Disk Partitions Section for details on changing disk partitions. 

* * • NOTE • * * 

If changes are going to be made to the disk partitions on which OS/MP 4.1C will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4.1C can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 
selectChange Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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Help may be requested at any ramdisk prompt by entering a question mark by it- 
self.Table 26 shows edit commands available when entering text in response to 
prompts: 



Table 26. Input Editing Commands 



Character 


Interpretation 


backspace (^U) 


delete last input character 


delete (^7) 


delete last input character 


'^U 


erase input line 


'^R 


redisplay input line 


^W 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return (-^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



# cd / 

# rm "f /core 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix that problem). In the event of a fatal error during software instal- 
lation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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For a dataless client installation, there are three informational menus: 

D Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

D Dataless Install Identification - specifies the dataless client's name and the 
servers Internet address. 

□ Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system. For a dataless system, the /usr files should have 
already been installed on the server. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Changing an entry at the Standard Filesystem Definition 

The following steps assign the /usr filesystem to rootbeer:/export/exec/Series5., 
rather than using the default of /usr being a subdirectory of the root filesystem. 

To modify the /usr filesystem, enter the number 3. 

Enter number of filesystem to change (^l'..'5M, 
continue', 'previous', 'cancel' or '?' for help: 3 

The usr menu will be highlighted, and the system will request a disk partition. The 
format is host:path, where host is the name of the server from which the /usr files 
will be used, path is I export! exQcl architecture (which was created by running con- 
fig_server) where export is your export directory, and architecture is the architec- 
ture of your dataless client. Assign it to rootbeer:/export/exec/S4000. 

The new arrangement is displayed as shown in Figure 79. 
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The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a partition of a local disk. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 79 shown below, the notation "(required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 



standard Filesystem Definition 

1} root on sdOa (required) 

2) swap on sdOb (required) 

3) /usr rootbeer: /export/exec/S4000 (required) 

4) /var on root partition 

5) /tmp on root partition 

Disk Partitions (sizes in MB) 
(a) (b) <c) ^d) ie) if) 

sdO: 8.4 32.4 191.1 9,3 

sdl: 8.4 32.7 190.9 9.6 



(g) 

141.1 
140.8 



ih) 



Enter number of filesystem to change (*1'..*5'), * continue', 'previous' 
' cancel ' , or ' ? ' for help : 



Figure 79. Sample Standard Filesystem Definition Menu for Dataless Clients 



To modify the /var filesystem, enter the number 4. 



Enter number of filesystem to change (^1'..'5'), 
'continues ^previous', 'cancel' or '?' for help: 4 



The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



Enter name of disk partition or hosttpath for /var 
filesystem, ^noneS "^C, or^?' for help: sdOd 



The new arrangement is displayed as shown in Figure 80. 
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Standard Filesystem Definition 

1} root on sdOa (required) 

2) swap on sdOb required) 

3} /usr on rootbeer: /export/exec/s4000 (required) 

4) /var on sdOd 

5} /tmp on root partition 









Disk Partitions (sizes 


in MB) 








(a) 


(b) 


(c) (d) (e) 


(f) 


(g) 


(h) 


sdO: 


8.4 


32.4 


191.1 9.3 





141.1 





sdl: 


8.4 


32.7 


190.9 3,6 





140.8 






Enter number of filesystem to change {'I'-.^S'), ^continue', ^previous', 
'cancel', or '?' for help: 



Figure 80. Modified Standard Filesystem Definition Menu for Dataless Clients 

Once all changes for the standard filesy stems have been made, enter continue: 



Enter number of filesystem to change ('!'.. ^5'), 
'continue', 'previous', 'cancel', or '?' for help: continue 

Next you are asked to verify the /usr partition. If the value is correct, enter yes to 
proceed to the Dataless Install Identification Menu: 

Is rootbeer: /export/exec/S4000 the correct host Vpath for ^ 
the /usr partition? 

('yes', 'no', "^C, or '?' for help): yes 
The Dataless Install Identification Menu 

The Dataless Install Identification Menu is a new menu that only appears when the 
/usr partition in the Standard Filesystem Definition Menu specifies that the /usr 
files will be NFS-mounted from another machine, and therefor, a dataless installa- 
tion. 

This menu was added so that it is no longer necessary to hand modify the /etc/hosts 
and /etc/hostname.eiO files. In releases prior to OS/MP 4.1C, at the completion of 
the dataless installation, the user had to exit to a Bourne Shell, and modify these 
files by hand. 

Figure 81 shows the Dataless Install Identification Menu. 
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Dataless Install Identification Menu 

1} Client Machine Name - <undefined> 

2) Internet address for rootbeer - <undefined> 



Enter selection number {'l'..^2'), 'continue', 'previous' 
'cancel', or '?' for help: 



Figure 81. Dataless Install Identification Menu for Dataless Clients 

The Client Machine Name is simply tlie name of the Dataless Client that you are 
currently installing. 

The Internet address is the address of the server from which the /usr files will be 
used. In this case the server is rootbeer. 

Both of these variables must be set before continuing. After these values have been 
entered correctly, enter continue. Next you are asked to verify the values en- 
tered. If the values are correct, enter yes to proceed to the Media Identification 
Menu. 

Installation Media Identification Menu 

The Installation Media Identification Menu describes which media will be used 
during the installation. 

On Series S4000 systems, the default values are determined by how the ramdisk 
was booted. 

Figure 82 shows the Installation Media Identification Menu of a S4000 machine 
that was booted from a local tape device stl (SCSI address 5). 

Installing from a Tape 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to ' local - 
host'. The Installation media type must also be set to 'Tape'. 

Installing from a remote tape drive requires that all the fields be set: 
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Installation Media Identification 

1) Installation media type - Tape 

2) Tape drive = /dev/nrstl 

3} Local Internet address = 0.0.0.0 {required for remote tape) 

4) Network broadcast mask s; OxffffOOOO {required for remote tape) 

5) Tape host ~ localhost {127,0.0.1) 



Enter selection number ('l'..'*5M^ 'continue', 'previous', 'cancel', or '?'for 
help: 



Figure 82. Installation Media Identification Menu - Local Tapehost 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in /etc/hosts or the NIS/YP hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Intemet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 83 shows the Tape Drive Identification menu of a system that was booted 
from a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 
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Installation Media Identification 

1) Installation media type = Tape 

2) Tape drive - /dev/nrstO 

3) Local Internet address = 192.9.3.4 {required for remote tape) 

4) Network broadcast mask = OxffffffOO ^required for remote tape) 

5) Tape host ~ tape-n-boot-serv {192,9.3.1) 



Enter selection number ('!',. ^5')* ^continue', 'previous'/ 'cancel', or '?'for 
help: 



Figure 83. Installation Media Identification Menu - Remote Tapehost 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO (/dev/srl if 
installing from sv2 on a Cougar controller) and the CD host field be set to 'lo- 
calhost'. Figure 84 shows the Installation media type menu with the CD-ROM 
parameters set to install from CD-ROM. 

Network and remote CD-ROM Installations 

Figure 85 shows the Installation media type menu with the Network parameters set 
to install from the network or a remote CD-ROM. Installations of this type require 
that all the fields be set as follows: 

Installation media type must be set to Network 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /cdrom, then the installation path 
is simply /cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host' s /.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 
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Installation. Media Identification 

1) Installation media type ~ CD-ROM 

2) CD drive ^ /dev/srO 

3) Local Internet address = 0.0.0.0 (required for remote tape) 

4) Network broadcast mask ~ OxffffOOOO {required for remote tape) 

5) CD host = localhost {127.0.0.1) 



Enter selection number {^1' . .^5') , ^continue', 'previous', 'cancel' ^r or '?''for 
help: 



Figure 84. Installation Media Identification Menu - Local CD-ROM 



Installation Media Identification 

1) Installation media type = NetworJc 

2) Installation directory - /cdrom 

3) Local Internet address = 192.9.3.4 {required for remote tape) 

4) Network broadcast mask = OxffffOOOO {required for remote tape) 

5) Network host ~ ginger {192,9.3.1) 



Enter selection number (^1'.,'5')/ ' continue S 'previous', 'cancel', or '?'for 
help: 



Figure 85. Installation Media Identification Menu -Remote CD-ROM 
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The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Class B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the installation directory, 
which is used to determine it's Internet address. 

For a remote CD-ROM install, the nethost must have /cdrom in it's /etc/ex- 
ports file, and must export it. Also, the rpc.mountd(8), nfsd(8), and rarpd(8) dae- 
mons must be running on ne tho s t . 

When the details of the media have been entered correctly, enter continue. 

Root Files Installation 

You are then asked if you want to install just the mandatory root files. This is asked 
as a confirmation before starting the installation: 

After entering yes, the installation is performed. 
The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesy stems (root(/), /usr, possibly /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. install mandatory root files 

When installation has finished, the ramdisk menu is displayed (see Figure 86). 
If the installation failed, call Customer Support. 

Rebooting from the Ramdisk 

After a successful installation, and after running config_server on your server, start 
UNIX by rebooting as shown in Figure 87. 

At the Reboot System menu select Boot Unix as shown in Figure 87: 

( Enter selection number ( ^1' . , ''3 ' ) or '?' for help: 1 . j 
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Ramdisk 



1) Change Disk Partitioning 

2) Install Software 

3) Invoke a Bourne Shell 

4) Reboot System 

5) Halt System 



Enter number of function to execute {*1'..*5', or *?' for help) 



Figure 86. Ramdisk Menu 



Reboot System 



1) Boot Unix 

2) Boot on ramdisk 

3} Return to Main Menu 



Enter selection number {^1'..'3') or '?' for help: 1 



Figure 87. Reboot System Menu 
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After selecting 1, there is a short pause, and then: 

/^Automatic boot enabled. Type Control -C to abort 
ROM> boot 

Boot: sd.si (0, 0, 0) /vmunix 
Entry: OxfdOSOOOO 
Size: 0xd6000+0x33358+0x81548 



OS/MP 4.1C„Export (GENERIC /root) #0: Tue Feb 1 15:52:44 

1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 

Solbourne Computer, Inc. 

Disabling tftp 

If the ramdisk was loaded from a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system from which the tape 
was read. 

First, comment out the line, as shown below, in /etc/inetd.conf: 



#tftp dgram udp wait root /usr/etc/in, tftpd in.tftpd 
/tftpboot 



Next, determine the process ID of inetd(8): 

f^tapehost# ps ax | egrep inetd ' 

249 ? I 0:01 inetd 

541 p3 R 0:00 egrep inetd ^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

Last, signal inetd to re-read the configuration file: 



ipBijiiiliiiiii^ 



I 



At this point, the system configuration information must be specified as described 
in the s&ction After Installing... 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4.1C_Export (GENERIC/root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

Automatic reboot in progress... 
Wed Feb 2 09:22:25 MDT 1994 
checking quotas: done. 

This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix. 

What is this system's name (default = ^standalone'): 
habit rai 1 <Rettim> 

What is its Internet address (0 for none, default = 
192.9.3.4)? <Rettim> 

What is the network broadcast mask {default ~ OxffffffOO)? 
<R0turn> 

What is the NIS domain name {^none' for none, default - 
* none ' ) ? Rodent . COM<R0tum> 

What directory should be used for automatic savecore files 
('none for none, default = Vvar/crash/habitrail' ) ? 
<Retum>> 



• • * NOTE • • • 
Using the default 'none' for the NIS domain name disables the NIS/YP services. 
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Time zone 


choices are: 








Australia/ 


GMT+11 


GMT- 3 


GMT6 


Mideast/ 


Brazil/ 


GMT+1 2 


GMT-4 


GMT7 


NZ 


CET 


GMT413 


GMT- 5 


GMT 8 


Nava j o 


CST6CDT 


GMT+2 


GMT- 6 


GMT9 


PRC 


Canada/ 


GMT+3 


GMT-7 


Greenwich 


PST8PDT 


Chile/ 


GMT+4 


GMT- 8 


HST 


Poland 


Cuba 


GMT+5 


GMT- 9 


Hongkong 


ROC 


EET 


GMT+6 


GMTO 


Iceland 


ROK 


EST 


GMT+7 


GMTl 


Iran 


Singapore 


EST5EDT 


GMT4 8 


GMTIO 


Israel 


Turkey 


Egypt 


GMT+9 


GMTll 


Jamaica 


UCT 


Factory 


GMT-0 


GMTl 2 


Japan 


US/ 


GB-Eire 


GMT-1 


GMTl 3 


Libya 


UTC 


GMT 


GMT- 10 


GMT2 


MET 


tiniversal 


GMT+0 


GMT- 11 


GMT3 


MST 


W-SU 


GMT+1 


GMT- 12 


GMT4 


MST7MDT 


WET 


GMT+10 


GMT -2 


GMT5 


Hexico/ 


Zulu 



(V indicates time zone prefixes) 



Enter time zone (default - ^ US /Mountain M : <R6turn> 

What is today's date (mm/dd/yyyy, default = 2/1/1994)? <Retum> 
What time is it (24-hour hh;mm, default - 16:55)? <R6turn> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (ra/d/y) 
Time 



habi trail 

192.9.3.4 

OxffffffOO 

Rodent . COM 

/var/crash/habi trail 

US /Mountain 

2/1/1994 

16:55 



Are these correct (^yes' or *no')? 
yes 

Setting netmask of eiO to 255*255*255*0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on habitrail. 

New password: 

Retype new password: 

Continuing boot 

starting rpc and net services: portmap [ 



.] 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on). 

• * * NOTE * * * 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol- C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 

ijiSilliijH 

If the system booted successfully originally, you may instead log in as root: 

J;ii|llliiii|ji;i§^^ 

In either case, if a file exists that tells the system it has been configured, remove it: 

IplliiiiiiiiH 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

Otherwise, use fastboot: 

ipillPiHiiiHiHlili^ 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Before Installing... 



Installing OS/MP 4. IC 
on a Diskless Client 



Any host on a network must be added to the hosts database. Before you can add a 
host to either database, a name and an address must be chosen for that host. Be sure 
both are unique for your network.There are three forms of network information da- 
tabases to be considered. 

□ Static files - this is the simplest form of the databases: two files, /etc/hosts and 
/etc/ethers. 

O Network Information Service - NIS, formerly called Yellow Pages (YP), is a 
centralized version of the static files approach. Fundamentally, one system, the 
NISA'P master, uses the static files. Other systems ask the master to look up 
entries in its files. 

□ Domain Name Service - DNS is part of the software used to administrate the 
Internet, and is beyond the scope of this document. If you are using it, contact 
your system administrator for information on updating entries in it. 

If you are using NIS/YP, the following actions must be taken on the NIS A^P mas- 
ter. If you are using static files, these actions must be taken on the system that is to 
act as a server (by providing either its tape or disk drive). Only the superuser (ac- 
count name root) is allowed to update these files. 

First: Update the hosts database with the name and IP address chosen for the new 
client by adding a line of the following form to /etc/hosts: 

192.1.3.42 hamster 

Next: If you are installing a diskless client, update the ethers database by adding a 
line of the form below to /etc/ethers. The six colon-separated numbers are the ones 
displayed by the system when the power is turned on. The name must be the same 
as was added to the hosts database. 

0:0:8e:10:0:16 hamster 
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Finally: If you are using NIS/YP, the working copy of the database must be updat- 
ed: 



iiiiiii 



Installing... 



* * * NOTE * * • 

The make command should be executed on the NIS/YP master server only. 

Before installing a diskless client, you must have already installed the server. On 
the server, you must also have run config_server for this client's architecture, and 
you must have run install_client for this machine. Refer to Installing OS/MP 4.1C 
on a Server for details. 



Setting BootROM Variables 



The Solboume diskless client must have the proper bootROM environment vari- 
ables set, in order to boot from a server by default. The following tables list vari- 
ables that must be set on a Solboume client. 

Table 27. Variables that must be set on a Solboume Series 5, 5E or 6 Client 



Variable 


Sample Value 


DEFAULTROOT 


iii]^.t\{„hostnumber) 


DEFAULTBOOT 


/ex^ort/root/clientname/Ymunix 


DEFAULTSWAP 


fexporVswapclientname/swa^.clientname 


DIAGBOOT 


/export/exec/SeriesS/kvm/stand/dg/or a SeriesS 
client 


/export/exec/Series6/kvm/stand/dg/or a Series6 
client 


DIAGSERVER 


i{tp.ei(„hostnumber) 


CONSOLE 


bw(),cg(),zs(),orfb() 
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Table 28. Variables that must be set on a Solboume Series S4000 Client 



Variable 


Sample Value 


DEFAULTROOT 


i{t^.d(„hostnumber) 


DEFAULTBOOT 


/c\ients/root/clientname/\mumx 


DEFAULTSWAP 


/cWents/swapclientname/swap.clientname 


DIAGBOOT 


/clients/exec/S4000/kvm/stand/dg 


DIAGSERVER 


tftp.ei(„hostnumber) 


INPUT-DEVICE 


keyboard, ttya, or ttyb 


OUTPUT-DEVICES 


screen, ttya, or ttyb 



In the tables above, clientname represents the name of the diskless client and host- 
number represents the last portion of the intemet address of the server. For exam- 
ple, if the server's Intemet address is 192.9.201.134, the hostnumber is 134. 

The acceptable settings for CONSOLE depend on the version of the bootROM in 
the system. 

The diskless client must have the proper bootROM environment variables set to 
boot from a server by default. To set the variables: 

Turn on the client. 

Set the following bootmode variables: 

/^ROM> setenv de£aultroot: tf tp . ei( , , hostnumber} 

ROM> setenv defaultboot /export /root /cliei3ti3ame/vmunix 

ROM> setenv default swap 

/export /swap/ cl i entname/8vra.p .alien tname 

ROM> setenv diagboot 

tftp,ei(, , hostnumber) /export/exec/kvro/type/stand/dg ^ 

In the commands above, clientname represents the name of the diskless client, 
and hos tnumber is the last portion of the intemet address of the server. For ex- 
ample, if the server's intemet address is 192.9.201.134 the hostnumber is 134. 

The type can be SeriesS, Series6 or S4000, or a directory name comprised of a 
basename standing for the machine architecture and an extension standing for the 
operating system and release level, as created by the -n option of config_server; 
for example, S4000.osmp.4.1A. 
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After Installing... 



Set the BOOTMODE to auto and reboot: 



ROM> detenv bootmode auto 

ROM> b 



* • • NOTE * * * 

If the system reports a protocol error while attempting to boot, kill and restart in- 
etd(8) on the server. 



When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/MP 4.1C„EKport (GENERIC /root) #0: Tue Feb 1 15:52:44 
1994 

Copyright (c) 1989-1994 Sun Microsystems, Inc. and 
Solbourne Computer, Inc. 

Automatic reboot in progress... 
Wed Feb 2 09; 22; 25 MDT 1994 
checking quotas; done. 



This system has not yet been configured. Several values 
need to be set before the system can come up to multi-user 
Unix. 

What is this system's name (default = 'standalone'); 
babitraiX 

What is its Internet address (0 for none, default = 
192.9.3.4)? <Retum> 

What is the network broadcast mask (default « OxffffffOO)? 
<Return> 

What is the NIS domain name ('none' for none, default = 
' none ' ) ? Rodent . COM 

What directory should be used for automatic savecore files 
('none' for none, default = Vvar/crash/habitrail' ) ? 
<Return> 



* * • NOTE * • * 
Using the default 'none' for the NIS domain name disables the NIS/YP services. 
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Time zone 


choices are: 








Australia/ 


GMT+11 


GMT- 3 


GMT6 


Mideast/ 


Brazil/ 


GHT+12 


GMT-4 


GMT7 


N2; 


CET 


GMT+1 3 


GMT-5 


GMT 8 


Navajo 


CST6CDT 


GMT+2 


GMT- 6 


GMT 9 


PRC 


Canada/ 


GMT+3 


GMT -7 


Greenwich 


PST8PDT 


Chile/ 


GMT+4 


GMT- 8 


HST 


Poland 


Cuba 


GMT+5 


GMT -9 


Hongkong 


ROC 


EET 


GMT+6 


GMTO 


Iceland 


ROK 


EST 


GMT+7 


GMTl 


Iran 


Singapore 


EST5EDT 


GMT+8 


GMT 10 


Israel 


Turkey 


Egypt 


GMT+9 


GMTll 


Jamaica 


UCT 


Factory 


GMT-0 


GMTl 2 


Japan 


US/ 


GB-Eire 


GMT~1 


GMTl 3 


Libya 


OTC 


GMT 


GMT-XO 


GMT2 


MKT 


Universal 


GMT+0 


GMT- 11 


GMT3 


MST 


W-SU 


GMT+1 


GMT-12 


GMT4 


MST7MDT 


WET 


GMT+10 


GMT -2 


GMT5 


Mexico/ 


Zulu 



( V indicates time zone prefixes) 



Enter time zone (default - *US/Mountain') : <Retum> 

What is today's date {mm/dd/yyyy, default = 2/1/1994)? <Return> 
What time is it (24-hour hh;mm, default = 16:55)? <Return> 



Current settings are: 
Host name 
Internet address 
Network mask 
NIS domain 
Savecore directory 
Time zone 
Date (m/d/y) 
Time 



habi trail 

192.9.3.4 

OxffffffOO 

Rodent. COM 

/var/crash/habi trail 

US/Mountain 

2/1/1994 

16:55 



Are these correct (^yes' or ^no')7 
yes 

Setting netmask of eiO to 255.255.255,0 

Tues Feb 1 09:22:25 MDT 1994 

Setting password for root 

Changing password for root on habitrail* 

New password: 

Retype new password: 

Continuing boot 

starting rpc and net services: portmap [ 



.] 
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Reconfiguring the System 



You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you fmd that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button (for Series 
S4000 machines, cycle the power off and on). 

* * * NOTE * * * 

If automatic boot is enabled, to interrupt the reboot by typing Control-C in the ear- 
ly stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 



rROM> boot -s 



If the system booted successfully originally, you may instead log in as root: 



(^habi trail login: root 
Password: 



"A 



In either case, if a file exists that tells the system it has been configured, remove it: 



( # XTO /etc/sys_conf /system-configured 



The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 



J 



(# exit 


J 


Otherwise, use fastboot: 


( # /etc/ fastboot 


) 



The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Changing Disk Partitioning 

All hard disks are shipped with a default partitioning. Disk partitioning is useful 
for: 

□ Changing the size of a partition 

□ Assigning secondary swap space before installation 
D Assigning mount points 

OS/MP 4.1C uses the default partitions in the following way: 

Table 29. Default Disk Partitions and Filesystem Assignments 



Partition 


Filesystem 


a 


/ 


b 


swap 


d 


/var 


g 


/usr 



* • * CAUTION * • * 

Changing the size of a partition destroys any information on that partition. 

* • * NOTE * * • 

If you change the partitioning on the drive containing the root partition, you must 
reinstall the operating system. 

The following instructions assume the ramdisk has already been loaded, as de- 
scribed in the Starting Dishful Installation section. 

After selecting Change Disk Partitioningfrom the ramdisk menu (as 
shown in Figure 88), a spinner is displayed while the partition tool starts up. 

Once its initialization is complete, it displays a description screen and asks if you 
wish to continue. Answering 'no' returns to the ramdisk menu. Answering 'yes' 
produces a menu of disks installed in the system (see Figure 89). If a disk is missing 
from this menu, verify that the SCSI address is set correctly on the drive, and that 
the cables are firmly seated. 
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1) Change Disk Partitioning 

2} Install Software 

3} Invoke a Bourne Shell 

4} Reboot System 

5) Halt System 



Ramdisk 



Enter number of function to execute (*1'..^5', or ^?' for help): 1 



Figure 88. Ramdisk Menu 



Select Disk to Partition or Review 



1) sdO {191.1 Mb) 

2) sdl {193.8 Mb) 



Enter disk number, '?', or *exit' : 1 



Figure 89. Disk Partitioning Menu 



Partition or Review Disk 
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To return to the ramdisk menu, enter 'exit' at the disk menu. 

Select the disk you wish to examine and proceed to section, "Partition or Review 
Disk". This tool is also available on installed systems in /usr/etc/partition. 



Upon selecting the disk you wish to examine, a screen describing the disk is dis- 
played as shown in Figure 90. 



Partition or Review Disk 



Disk sdO : 

Total Disk Size: 191.1 Mb 

a : 8.4 Megabytes 

b: 32.3" Megabytes 

c: 191.1 Megabytes 

d : 9.3 Megabytes 

e : 0.0 Megabytes 

f: 0,0 Megabytes 

g: 141.1 Megabytes 

h: 0.0 Megabytes 



1. Resize partition- 

2 . Change mount points 

3. Overlay with template 

4 . Store as new template 



Please enter menu number! 



5. Change display parameters 

6. undo last action 

7 . Undo ALL actions 

8 . Return to previous menu 



Figure 90. Partition or Review Disk Menu 



To change the size of a partition, see "Resizing Partitions," section. To modify 
mount points, see "Changing Mount Points". For discussion of templates, see 
"Templates". Other available actions are: 

□ Change display parameters - modifies how partition sizes are displayed, in 
megabytes, blocks (sectors), or cylinders/tracks/sectors. 

□ Undo last action - does just that. Only the most-recent change is remembered, 
and undo counts as a change. Therefore, two undos in a row have no net effect. 

□ Undo ALL actions - discards all changes made since selecting this disk from 
the disk menu. It is possible to undo an undo all. 
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No changes are made to the disk itself until returning to disk menu. If changes have 
been requested: 



/^Please enter menu number: 8 

Template has been modified. Do you wish to accept these 
changes? 

*yes' or 'no' to exit, any other input to continue editing; 
yes 



Resizing Partitions 



This section demonstrates changing the size of partitions by increasing the size of 
partition d to 12 megabytes, taking the additional space from the g partition. 

First, select the resize partition action from the Part it ion or Review Disk 
menu: 



C 



Please enter menu number: 1 



This causes the Resize partition menu entry to highlight, and the following ques- 
tions to be asked: 



3 



/^Please specify partition to be resized: d 
Enter size of partition d in Megabytes: 12 
Please specify partition to contribute this space; g 

Figure 91 shows the updated screen with the new sizes. Observe that the d partition 
is not exactly 12 megabytes. This is because partition sizes may only be changed 
in fixed quantities determined by cylinder boundaries (the number of sectors per 
track and the number of heads in the drive). 

Also, the tool is asking for another partition to resize. It will continue to do so until 
a blank line is entered by just typing <Return> at the prompt, Please specify 
partition to be resized: 

The default partitions can be changed during the install procedure. We recommend 
using partition c for the entire disk. 

OS/MP 4.1C supports booting from any configured disk, whether IPI, SMD, or 
SCSI, with the following exceptions: 

• You cannot boot from a disk connected by an MCAB, and 

• You cannot boot from a SCSI disk in a BoSS tray numbered higher than sd3 1 . 
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Disk sdO: Maxtor LXT-200 
Total Disk Size: 191.1 Mb 



a: 


8.4 


Megabytes 


b: 


32.3 


Megabytes 


c: 


191.1 


Megabytes 


d: 


12.1 


Megabytes 


e: 


0.0 


Megabytes 


f : 


0.0 


Megabytes 


g: 


138.3 


Megabytes 


h: 


0.0 


Megabytes 



1. Resize partition 

2 . Change mount points 

3. Overlay with template 

4 . Store as new template 



Partition or Review Disk 



/ 



{ swap } 



/usr 



5. Change display parameters 

6. Undo last action 

7 . Undo Ml> actions 

8 . Return to previous menu 



Please specify partition to be resized: Return 



Figure 91. Partition or Review Disk Menu - Resizing Partition 

For example, if you have two SCSI drives, you may choose either sdO or sdl as 
your DEFAULTROOT device. The root(/) file system may be on any partition on 
the boot disk. See section on page 25 for setting DEFAULTROOT. The installation 
tools and the supplied "GENERIC" kemels require that the root and usr file sys- 
tems for IPI-based systems be assigned to partitions of the first four drives of the 
first controller. 

The Series5, SeriesSE and Series6 generic kemels support four SCSI disks on the 
I/O ASIC SCSI controller as well as four VMEbus "xd" disk controllers. Each 
"xd" disk controller can support four disks in the generic kemels. 
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Example partitions for these drives are listed in the following tables: 
Table 30. Example IPI Disk Partitions 



IPI Disks 1 


Partition Use 


1.2 Gbytes 
512 byte sectors 


3.0 Gbytes 
512 byte sectors 


Sectors 


Size 
(Mbytes) 


Sectors 


Size 
(Mbytes) 


a 


/ 


18522 


9 






b 


swap 


65856 


32 






c 


all 


1679328 


820 






d 


/var 


20580 


10 






g 


/usr 


1574370 


768 






h 


unmounted 


N/A 


N/A 







Table 31. Example SCSI Disk Partitions 



SCSI Disks (sdO) 


Partition Use 


327 Mbytes 


661 Mbytes 


200 Mbytes 


Sectors 


Size 

(Mbytes) 


Sectors 


Size 
(Mbytes) 


Sectors 


Size 
(Mbytes) 


a 


/ 


16800 


8 


16695 


8 


16800 


8 


b 


swap 


66150 


32 


66780 


32 


66220 


32 


c 


all 


639450 


312 


1292670 


631 


391300 


191 


d 


/var 


19425 


9 


19080 


9 


18963 


9 


g 


/usr 


537075 


262 


1190115 


581 


288960 


141 
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Changing Mount Points 



Partitions that will contain filesystems must be given mount points. A mount point 
is where in the directory structure the filesystem will appear. Two filesystem 
mount points that must be defined on all systems are / (also called root) and /usr. 
The following example shows how to define a new filesystem. 

To define a new filesystem named /bench on partition b, begin by entering 2 in re- 
sponse to the Partition or Review Disk menu: 



r Please enter menu number: 2 



This causes the Change mount points entry to be highlighted, and you 
may specify the partition and desired mount point: 



D 



(^Change mount point for which partition (or "?') : b 

Enter full unix pathname on which to mount this partition^ 
* none ' , or * ? ' 

-> /bench 

V / 

The display is updated to reflect the new mount-point, as shown in Figure 92. As 
with changing partition with changing partition sizes, the tool is asking for another 
mount point to change. Entering a blank line by pressing <Return> will return to 
the menu prompt. 

To define a swap partition, proceed as if defining a mount point, but enter either 
' 'swap' ' or ' 'primary' ' as the partition name. Only one partition should be labeled 
primary. This partition is verified to be sufficiently large, and is presented to the 
system as the primary swap space, however, you can add additional swap space by 
labeling the others "swap". The primary swap area must be at least 32MB. 

Other swap areas should be listed in the /etc/fstab file and enabled by the 
swapon(8) command from within the /etc/rc.local file. 
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Partition or Review Disk 



Disk sdO: 

Total Disk Size: 191.1 Mb 



/ 



a: 


8.4 


Megabytes 


b: 


32.3 


Megabytes 


c: 


191.1 


Megabytes 


d: 


9.3 


Megabytes 


e: 


0.0 


Megabytes 


f: 


0.0 


Megabytes 


g: 


141.1 


Megabytes 


h: 


0.0 


Megabytes 



/bench 



/usr 



1. Resize partition 

2 . Change mount points 

3 . Overlay with template 

4 . Store as new template 



5. Change display parameters 

6. Undo last action 

7. Undo ALL actions 

8. Return to previous menu 



Change mount point for which partition: Return 



Figure 92. Partition or Review Disk Menu - Changing Mount Points 
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Templates 



Overlaying with a template is a fast way to change all the partition sizes on a disk 
simultaneously. Initially, only the Solboume standard templates are available. 
However, if a customized template is saved, it can be used just as readily as the 
standard templates. This feature is mainly used when there are several identical 
disks in a system. 

After a particular set of partition sizes has been settled upon, it can be saved as a 
new template (menu item 4). This new template is stored on the ramdisk, and so is 
lost when the system is next halted or rebooted. 

* * * CAUTION * * * 

Applying a template from one type or size of disk to a different type or size of 
disk is very likely to result in corrupted filesystems on the modified disk. Such 
a mistake usually causes a system panic at some point (possibly several days) 
in the future. 
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NAME 

mpstat - show multi-processor usage or cache statistics 

SYNOPSIS 

/usr/kvm/mpstat [ -x I -c ] [ interval [ count] ] 

AVAILABILITY 

This program is only available on Solbourne multiprocessing machines. 

DESCRIPTION 

mpstat enters the system and shows average and per-processor percentage usage data 
during a particular time interval. The first group of data represents the average of all the 
processors in the system while the second and subsequent data groups represent partic- 
ular processors, with their particular name designations above each group. 

Without an inten/al or count option, mpstat displays a one-line summary of MP system 
activity since the system has been booted. If interval is specified, mpstat summarizes 
activity over the last interval seconds. If a count is given, the statistics are repeated 
count Wmes. 

The particular fields of each data group give a breakdown of percentage usage of CPU 
time: 

us user time for normal processes 

ni time for processes with an altered scheduling priority {nice(l)) 

sy system time 

id CPU idle 

OPTIONS 

-X Displays, per cpu, the amount of time spinning (sp), the amount of time in diskwait 
(dw), and the amount of time waiting on cross-service calls (sv). 

-c Displays, per cpu, the percentage of cache hits (hi) and cache bandwidth used (bw) 
for the level 2 (L2) and level 3 (L3) caches. It also displays the estimated percen- 
tage of the Kbus bandwidth (KB) which is being used (this is computed from the 
level 3 cache miss rate). This option is only available on SeriesS CPUs. 



FILES 



/dev/kmem 
/vmunix 



SEE ALSO 

mps(1), nice(1), ps(1), vmstat(8) 

BUGS 

The time spinning displayed by the -x option is only accurate for cpu 0. 
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NAME 



mps - display the status of current processes on an MP system 



SYNOPSIS 

/usr/kvm/mps [ [-]acCegjklnrSuUvwx ] [ -tx ] I [ num ] [ kernel-name ] [ c-dump-file ] [ 
swap-file ] 

AVAILABILITY 

This program is only available on Solbourne multiprocessing machines. 

DESCRIPTION 

mps displays information about processes on an MP system, mps is identical to ps(1) 
except that the CPU field was added to show the cpu number on which the process is or 
was running. Normally, only those processes that are running with your effective user ID 
and are attached to a controlling terminal (see termio(4)) are shown. Additional 
categories of processes can be added to the display using various options. In particular, 
the -a option allows you to include processes that are not owned by you (i.e., that do not 
have your user ID), and the -x option allows you to include processes without control ter- 
minals. When you specify both -a and -x, you get processes owned by anyone, with or 
without a control terminal. The -r option restricts the list of processes printed to "running" 
processes: runnable processes, those in page wait, or those in short-term non- 
interruptible waits. 

mps displays the process ID, under RID; the control terminal (if any), under TT; the cpu 
time used by the process so far, including both user and system time), under TIME; the 
state of the process, under STAT; and finally, an indication of the COMMAND that is run- 
ning. 

The state is given by a sequence of four letters, for example, 'RWNA'. 



First letter 



indicates the runnability of the process: 



R Runnable processes. 

T Stopped processes. 

P Processes in page wait. 

D Processes in non-interruptible waits; typically short-term waits 

for disk or NFS I/O. 
S Processes sleeping for less than approximately 20 seconds. 

I Processes that are idle (sleeping longer than approximately 20 

seconds). 
Z Processes that have terminated and that are waiting for their 

parent process to do a wait(2V) ("zombie^' processes). 

Second letter indicates whether a process is swapped out: 

blank Represented as a SPACE character indicates that the process 

is loaded (in memory). 
W Process is swapped out. 

> Process has specified a soft limit on memory requirements and 

has exceeded that limit; such a process is (necessarily) not 

swapped. 

Third letter indicates whether a process is running with altered CPU scheduling 

priority (nice(1)): 
blank Represented as a SPACE character indicates that the process 

is running without special treatment. 
N The process priority is reduced. 

< The process priority has been raised artificially. 

Fourth letter indicates any special treatment of the process for virtual memory 
replacement. The letters correspond to options to the vadvise(2) 
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system call. Currently the possibilities are: 

blank Represented as a SPACE character stands for VA_NORM. 

A Stands for VA_ANOM. An A typically represents a program 

which is doing garbage collection. 
8 Stands for VA_SEQL. An S is typical of large image processing 

programs that are using virtual memory to sequentially address 

voluminous data. 

kernel-name specifies the location of the system namelist. If the -k option is given, c- 
dump-file tells mps where to look for the core dump. OthenArise, the core dump is 
located in the file /vmcore and this argument is ignored, swap-file gives the location of a 
swap file other than the default, /dev/drum. 

OPTIONS 

Options must all be combined to form the first argument. 

-a Include information about processes owned by others. 

■c Display the command name, as stored internally in the system for accounting pur- 
poses, rather than the command arguments, which are kept in the process address 
space. This is more reliable, if less informative, as the process is free to destroy 
the latter information. 

-C Display raw CPU time instead of the decaying average In the %CPU field. 

-e Display the environment as well as the arguments to the command. 

-g Display all processes. Without this option, mps prints only "interesting" processes. 
Processes are deemed to be uninteresting if they are process group leaders. This 
normally eliminates top-level command interpreters and processes waiting for users 
to login on free terminals. 

-j Display a listing useful for job control information, with fields PPID, PID, PGID, SID, 
TT, TPGID, STAT, UID, TIME, and COMMAND as described below. 

With this option, the STAT field has three additional letters: 

C indicates the process does not want SIGCHLD when a child changes state 

done to job control. 

E The process has completed an exec, and the parent can no longer change 

the process group of this process. 

O The process is an orphan, with no parent process to handle job control sig- 

nals. 

-k Normally, kernel-name defaults to /vmunix, c-dump-flle is ignored, and swap-file 
defaults to /dev/drum. With the -k option in effect, these arguments default to 
/vmunix, /vmcore, and /dev/drum, respectively. 

-I Display a long listing, with fields F, PPID, OP, PRI, Nl, SZ, RSS, and WCHAN, as 

described below. 

-n Produce numeric output for some fields. In a long listing, the WCHAN field is 
printed numerically rather than symbolically, or, in a user listing, the USER field is 
replaced by a UID field. 

-r Restrict output to "running" processes. 

-S Display accumulated CPU time used by this process and all of its reaped children. 

-u Display user-oriented output. This includes fields USER, %CPU, %MEM, SZ, RSS 
and START as described below. 

-U Update a private database where mps keeps system information. Include 'mps -U' 
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in the /etc/rc file. 

-V Display a version of the output describing virtual memory information. This includes 
fields RE, SL, PAGEIN, SIZE, RSS, LIM, %CPU and %MEM, described below. 

-w Use a wide output format (132 columns rather than 80); if repeated, that is, -ww, 
use arbitrarily wide output. This information is used to decide how much of long 
commands to print. 

-X Include processes with no controlling terminal. 

The following two options are mutually exclusive. When specified, these options must 
appear immediately following the last option. 

-tx Restrict output to processes whose controlling terminal is x (which should be 
specified as printed by mps; for example, t3 for /dev/tty3, tco for /dev/console, 
tdO for /dev/ttydO, t? for processes with no terminal, etc). This option must be 
the last one given. 

num A process number may be given, in which case the output is restricted to that 
process. This option must also be last, and must appear with no white space 
between it and the previous option. 

DISPLAY FORMATS 

Fields that are not common to all output formats: 

USER Name of the owner of the process. 

%CPU CPU use of the process; this is a decaying average over up to a minute of 

previous (real) time. Because the time base over which this is computed 
varies (since processes may be very young) it is possible for the sum of all 
%CPU fields to exceed 100%. 

Nl Process scheduling increment (see getpriority(2) and nice(3V)). 

SIZE 

SZ The combined size of the data and stack segments (in kilobytes) 

RSS Real memory (resident set) size of the process (in kilobytes). 

LIM Soft limit on memory used, specified using a call to getrlimit(2); if no limit 

has been specified, this is shown as xx. 

%MEM Percentage of real memory used by this process. 

RE Residency time of the process (seconds in core). 

SL Sleep time of the process (seconds blocked). 

PAGEIN Number of disk l/Os resulting from references by the process to pages not 
loaded in core. 

UID Numeric user-ID of process owner. 

PPID Numeric ID of parent of process. 

SID Numeric ID of the session to which the process belongs. SID = PGID = PID 

indicates a session leader. 

PGID Numeric ID of the process group of the process. 

TPGID Numeric ID of the process group associated with the terminal specified 

under TT (distinguished process group, see termio(4)). 

CP Short-term CPU utilization factor (used in scheduling). 

PRI Process priority (non-positive when in non-interruptible wait). 

START Time the process was created if today, or the date it was created, if before 

today. 



Solbourne Computer, Inc. 



6 March 1991 



MPS(1) 



UNIX Programmer's Manual 



MPS(1) 



WCHAN Event on which process is waiting (an address in the system). A symbol is 
chosen that classifies the address, unless numeric output is requested (see 
the n flag). In this case, the address is printed in hexadecimal. 

CPU Relationship between process and processor. Under the CPU field, the 

cpu number the process is or was running on is displayed. 



Flags (in hex) associated with process as in <sys/proc.h>: 

in core 

swapper or pager process 
process being swapped out 
save area flag 
process is being traced 

parent has been told that this process stopped 
user can set lock in core 
process in page wait state 
another flag to prevent swap out 
restore old mask after taking signal 
working on exiting 
doing physical I/O 
process resulted from vforkQ 
another vfork flag 
no vm, parent in a vforkQ 
init data space on demand, from vnode 
user warned of sequential vm behavior 
user warned of anomalous vm behavior 
timing out during sleep 
process is orphaned 
process is tracing another process 
process is being profiled and has a pending count increment 
selecting; wakeup/waiting danger 
favored treatment in swapout and pageout 
record-locking has been done 
tracing system calls 
SIGCHLD not sent when child stops 
process has completed an exec 
sunview window locking 

A process that has exited and has a parent, but has not yet been waited for by the 
parent, is marked <defunct>; a process that is blocked trying to exit is marked <exit- 
ing>; otherwise, mps makes an educated guess as to the file name and arguments 
given when the process was created by examining memory or the swap area. 

ENVIRONMENT 

The environment variables LC_CTYPE, LANG, and LC_default control the character 
classification throughout mps. On entry to mps, these environment variables are 
checked in the following order: LC_CTYPE, LANG, and LC_default. When a valid value 
is found, remaining environment variables for character classification are ignored. For 
example, a new setting for LANG does not override the current valid character 
classification rules of LC_CTYPE. When none of the values is valid, the shell character 
classification defaults to the POSIX.l "C" locale. 



SLOAD 


00000001 


SSYS 


00000002 


SLOCK 


00000004 


SSWAP 


00000008 


STRC 


00000010 


SWTED 


00000020 


SULOCK 


00000040 


SPACE 


00000080 


SKEEP 


00000100 


SOMASK 


00000200 


SWEXIT 


00000400 


SPHYSIO 


00000800 


SVFORK 


00001000 


SVFDONE 


00002000 


SNOVM 


00004000 


SPAGI 


00008000 


SSEQL 


00010000 


SUANOM 


00020000 


STIMO 


00040000 


SORPHAN 


00080000 


STRACNG 


00100000 


SOWEUPC 


00200000 


SSEL 


00400000 


SFAVORD 


02000000 


SLKDONE 


04000000 


STRCSYS 


08000000 


SNOCLDSTOP 


10000000 


SEXECED 


20000000 


SRPC 


40000000 



FILES 



/vmunix 
/dev/kmem 



system namelist 
kernel memory 
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/dev/drum swap device 

/vmcore core file 

/dev searched to find swap device and terminal names 

/etc/psdatabase system namelist, device, and wait channel information 

SEE ALSO 

kill(1), w(1), getpriority(2), getrlimit(2), wait(2\/), vadvise(2), nice(3V), termio(4), 
locale(5), pstat(8), mpstat(1) 

BUGS 

Things can change while mps is running; the picture it gives is at best a close approxi- 
mation to the current state. 
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NAME 

soipatch - install, list, remove patch packages 

SYNOPSIS 

soipatch [ -d spooLdir] [ -I patchjogfile ] 

DESCRIPTION 

soipatch allows for the installation, listing, and/or removal of patch packages. 

The Solbourne Patch Management System utilizes the SunOS/SVR4 packaging applica- 
tion software utilities. The System V ABI specifies a new model for the distribution for- 
mat of applications. This model is called software packages, and is supported by tools 
and utilities to create releasable distribution media. Software that is packaged using the 
ABI formats is guaranteed to install correctly, easily, and in a similar fashion on all ABI- 
compliant systems. 

Soipatch interfaces with the package utilities pkgadd, pkgrm, pkginfo, and pkgparam. 

Soipatch must be run as the super-user. 

OPTIONS 

-d patch_spooldir 

This is the directory where the patch packages reside prior to installation. These 
patch packages may have been obtained via anonymous ftp from 
solbourne.com, via email from SOLIS (Solbourne On-Line Information System) at 
solis@solbourne.com, or via tape from the Solbourne Technical Services group. 
Each patch package consists of a directory containing the actual package infor- 
mation files and package objects. The default patch spool directory area is 
/var/spool/pkg. The patch spool directory area can a Iso be defined by setting 
the PATCH_SPOOLDIR environment variable. 

-I patchjogfile 

This is the file specification of where the actions performed by soipatch are 
logged. The default soipatch logfile is /var/adm/patchjogfile. The soipatch 
logfile can also be defined by setting the PATCH_LOGFILE environment variable. 

USAGE 

The root account from which the soipatch utility is invoked should contain the following 
directories in the PATH environment variable to locate the soipatch utilities: /usr/bin, 
/usr/sbin, /usr/sadm/install/bin 

The Main Menu 

Soipatch presents a main menu entitled Solbourne Patch Management System after per- 
forming initialization and pre-processing steps. From the main menu you can select to 
install patch package(s), list currently installed patch package(s), or remove installed 
patch package(s). 

Help is available from all menu option screens by pressing the 'h' key. 

Common Command Keys/Cursor Movement 

Common screen manipulation functions available at the install, list, and remove screens 
are display next page ('n' key), display previous page ('p' key), scroll screen display up a 
line ('u' key), and scroll screen display down a line ('d' key). 
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The screen display can be captured to a user specified file from the solpatch install, list, 
and remove menus by entering 'c' at the prompt line. All pages of a multi-screen display 
will be captured. Multiple invocations of the capture option will append to the specified 
file if it exists. 

Help can be obtained by entering 'h' at the prompt lines of the install, list, and remove 
menus. 

An invalid option that is entered will cause the screen to beep. 

Install option 

Upon selecting the Install patch package(s) option from the main solpatch menu, a list of 
patch packages available for installation is presented. Information items displayed on 
this screen include the patch id number (listed with sequence numbers along the left side 
of the screen), install toggle field, type of patch package (M for mandatory, O for 
optional), and a description of the patch package. The full README file associated with 
a patch package can be displayed by entering the patch sequence number 
followed by the letter 'h'. 

By default, all patch packages with a type of "M" (mandatory) are presented with a install 
toggle field set to y and all patch packages with a type of "O" (optional) are presented 
with a toggle field set to 'n'. To toggle the install field for a patch package from y to 'n' or 
from 'n' to y, simply enter the patch id sequence number at the prompt line. 

During the pre-processing phase upon invocation of solpatch, a dependency check is 
performed on all patch packages currently installed and those available for installation in 
the patch spool directory. If an error is encountered during this phase the install toggle 
field will display a '-' for the patch package that encountered an error during the depen- 
dency check. Upon selection of this patch package, when attempting to toggle the install 
field from 'n' to y, an error window will be presented to the u ser informing of the patch 
packages on which this patch package depends, but were unable to be located as either 
installed or found in the patch spool directory. This patch package will not be allowed to 
be installed until the dependency errors are corrected. This will usually involve obtaining 
the missing patch package(s) via one of the methods mentioned above. 

For patch packages that have special installation instructions associated with them, a 
special character such as '*' will be displayed immediately to the right of the Type field. 
Special instructions regarding this patch package will be displayed to the user upon 
selection of this patch package. 

If a patch package is selected for installation, all patch packages which the selected 
patch package depend upon are automatically also selected for installation and the install 
toggle field set to y. Conversely, if a patch package is selected to toggle the install field 
from y to 'n', all patch packages which depend on the patch package will also have their 
install fields set to 'n'. 

When the user selects the 'i' (install) option, all patch packages which have the install 
toggle field set to y will be installed. As installation is occurring, status information will 
be displayed upon the screen and also logged to the patch logfile. Upon completion of 
installation, the user will be prompted to press a key and will then be returned to the sol- 
patch main menu. 
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List option 

Upon selecting the list patch package(s) option from the solpatch main menu, a list of 
patch package(s) currently installed on the system will be displayed. Information items 
displayed on this screen include the patch id number, type of patch package (M for man- 
datory, O for optional), and a description of the patch package. The full README file 
associated with a patch package can be displayed by entering the patch sequence 
number followed by the letter 'h'. 

Remove option 

Upon selecting the remove patch package(s) option from the main solpatch menu, a list 
of patch packages currently installed on the system are displayed. Information items 
displayed on this screen include the patch id number (listed with sequence numbers 
along the left side of the screen), remove toggle field, type of patch package (M for man- 
datory, O for optional), and a description of the patch package. The full README file 
associated with a patch package can be displayed by entering the patch sequence 
number followed by the letter 'h'. 

By default, all patch packages are presented with a remove toggle field set to 'n'. To tog- 
gle the remove field for a patch package from 'n' to y or from y to 'n', simply enter the 
patch id sequence number at the prompt line. 

For patch packages that have special removal instructions associated with them, a spe- 
cial character such as '*' will be displayed immediately to the right of the Type field. Spe- 
cial instructions regarding this patch package will be displayed to the user upon selection 
of this patch package. 

If a patch package is selected for removal, all patch packages which the selected patch 
package depend upon are automatically also selected for removal and the remove toggle 
field set to y. Conversely, if a patch package is selected to toggle the remove field from 
y to 'n', all patch packages which depend on the patch package will also have their 
remove fields set to 'n'. 

When the user selects the 'r" (remove) option, all patch packages which have the remove 
toggle field set to y will be removed. As removal of patches is occurring, status informa- 
tion will be displayed upon the screen and also logged to the patch logfile. Upon comple- 
tion of the removal process, the user will be prompted to press a key and will then be 
returned to the solpatch main menu. 



FILES 



pkginfo package characteristics file 

pkgmap package contents description file 

/var/adm/patch_logfile 

default solpatch log file 

/usr/bin/pkginfo display software package information 

/usr/bin/pkgparam displays package parameter values 

/usr/sbin/pkgadd transfer software package to the system 

/usr/sbin/pkgchk check accuracy of installation 

/usr/sbin/pkgrm removes a package from the system 
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ENVIRONMENT VARIABLES 

PAGER Solpatch checks the environment variable PAGER to determine 

what pager to use to display help and README files. If no 
PAGER is specified, 'more' will be used. 

SEE ALSO 

pkginfo(1), pkgparam(l), pkgadd(1 m), pkgchk(lm), pkgrm(1m), pkginfo(4), 
pkgmap(4), admin(4), prototype(4) 
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NAME 



dkcti - control special disk operations 



SYNOPSIS 

/usr/etc/dkcti disk command 

DESCRIPTION 

dkctI is used to enable or disable special disk operations. In particular, enabling or disa- 
bling of verified writes (write check functionality) is controlled by this program. 

The disk specification here is a disk name of the form /dev/rxxnp, where xx is the con- 
troller device abbreviation (xd, sd, etc.), n is the disk number, and p is the partition to 
which the operation applies. The partition specification is simply the letter used to iden- 
tify that partition in the standard UNIX system nomenclature. 

SUPPORTED COMMANDS 

wchk This function enables write checking for disks that support it for the named 

disk partition. This means that disk partitions with this feature enabled, all 
writes are verified to have been correctly written on the disk. This operation 
emphasizes data reliability over performance, although for each implemen- 
tation, the fastest reasonable method will be used (i.e., implemented in 
hardware, if possible). 

-wchk This disables write check functionality for the named disk partition. 

spin Same as -spin. 

-spin This function allows the administrator to take the particular device contain- 

ing the named partition offline. The drive is spun back up on the next 
access. 

suspend This function allows the administrator to suspend all I/O operations to the 

I/O bus containing the named partition. 

resume This function allows the administrator to resume I/O operations to the I/O 

bus containing the named partition. 

high This function places a higher priority for all operations which are destined to 

the named disk partition. High priority implies that the l/Os to this disk will 
be started in front of any other operations destined for normal priority dev- 
ices on the same I/O bus. Issuing two operations to a single high priority 
disk may cause the second command to be started before the first. This 
operation mode emphasizes the performance of particular drives over oth- 
ers and may be useful in performance tuning. 

-high This disables the high priority functionality for the named disk partition. 

BUGS 

Use of the dkctI command requires super-user permissions. 

There are many other features this program could control, and may in the future. 

FILES 

/dev/rxxnp 

SEE ALSO 

dkio(4S), sd(4S), xd(4S) 
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NAME 

iostat - report I/O statistics 

SYNOPSIS 

iostat [ -cdDltv ] [ -I a? ] [ disk ... ][ interval [ count] ] 

DESCRIPTION 

iostat can iteratively report terminal and disk I/O activity, as well as CPU utilization. The 
first report is for all time since a reboot and each subsequent report is for the prior inter- 
val only. 

In order to compute this information, the kernel maintains a number of counters. For 
each disk, seeks, data transfer completions, number of words transferred are counted; 
for terminals collectively, the number of input and output characters are counted. Also, 
at each clock tick, the state of each disk is examined and a tally is made if the disk is 
active. The kernel also provides approximate transfer rates of the devices. 

OPTIONS 

iostat's activity class options default to tdc (terminal, disk, and CPU). If any activity class 
options are specified, the default is overridden. Therefore, if only -d is specified, neither 
terminal nor CPU statistics will be reported. The last disk option specified (either -d or -D) 
is the only one that is used. 

-c Report the percentage of time the system has spent in user mode, in user mode 

running low priority processes, see nice(1), in system mode, and idling. 

-d For each disk, report the number of kilobytes transferred per second, the number 

of transfers per second, and the milliseconds per average seek (see BUGS 
below). 

-D For each disk, report the reads per second, writes per second, and percentage 
disk utilization. 

-I Report the counts in each interval, rather than reporting rates. 

-t Report the number of characters read and written to terminals. 

-V Normally, the statistics for each drive are printed on a single line. On systems 

where there are more than four drives, statistics for some drives are not printed 
due to limited space on the output line. The -v option prints the output vertically, 
one drive per line, allowing the statistics for all drives on the system to be 
printed. A header is printed and the CPU and TTY statistics are not printed. 

-I n Limit the number of disks included in the report to n; the disk limit defaults to 4. 
Note: disks explicitly requested (see d/s/c below) are not subject to this disk limit. 

of/s/f Explicitly specify the disks to be reported; in addition to any enumerated disks, 
any active disks up to the disk limit (see -I above) will also be reported. 

intervai Report once each /nten^a/ seconds. 

count Only print count reports. 



FILES 



/dev/kmem 
/vmunix 



SEE ALSO 

vmstat(8) 

BUGS 

Milliseconds per average seek is an approximation based on the disk (not the controller) 
transfer rate. Therefore, the seek time will be over-estimated in systems with slower 
controllers. 
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NAME 

oncpu - manipulate processors on which a process runs. 

SYNOPSIS 

/usr/etc/oncpu -pp/d 
/usr/etc/oncpu -ppid cpu_set 
/usr/etc/oncpu -ap/d 
/usr/etc/oncpu -npid 
/usr/etc/oncpu -A 
/usr/etc/oncpu -N 
/usr/etc/oncpu cpu_set [ command ] 

DESCRIPTION 

oncpu is used to manipulate the processors on which a process can run and to control 
whether processes have an affinity for the last processor on which they ran. Processor 
affinity specifies if a process is trying to run on the same CPU for an extended length of 
time. With affinity the CPU's local cache state is preserved, an advantage with large phy- 
sical caches. The disadvantage of affinity is that the latency until a process runs may 
increase. OS/MP implements a dynamic affinity mechanism which will balance load 
across available processors, with each process having an affinity to the processor on 
which it last ran. When the load becomes too large, reducing the likelihood of meaningful 
cache states being intact, affinity is disabled. This dynamic affinity mechanism is enabled 
by default, oncpu can be used to enable or disable this dynamic affinity per process, or 
for the entire system, oncpu can also limit processes to run on a restricted set of proces- 
sors. 

The numeric cpu_set field is interpreted as the processor number if the value is decimal 
or is a hexidecimal (i.e., preceded by Ox), bit mask with bits set for each CPU on which a 
process can run. In order to restrict a particular process to running on processor number 

0, use the cpu_set value 0. In order to restrict a particular process to run on processor 0, 

1 , 2, or 4, use the cpu_set value 0x17. 

When child is created its initial cpu_set and affinity are inherited from its parent. 

oncpu assumes that the kernel running is called /vmunix. If another kernel is running, a 
different l<emei_file must be specified at the end of the command. 

The oncpu command has a number of forms: 

oncpu -ppid 

Display the current cpu_set and affinity for process pid. 

oncpu -ppid cpu_set 

Restrict process p/dto run on the CPUs specified in cpu_set. 

oncpu -apid 

Enable dynamic affinity ior process pid. 

oncpu -npid 

Disable dynamic affinity ior process pid. 

oncpu -A 

Enable dynamic affinity for all processes on the system which have not had 
aff/My disabled via the -n option. 

oncpu -N 

Disable dynamic affinity ior all processes on the system. 

oncpu cpu_set [command] 

Execute the specified command, restricting it to to run on the CPUs specified in 
cpu_set. If command is not specified then the parent of oncpu is restricted to 
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run on the CPUs specified in cpu_set. 

NOTES 

Attempting to restrict a process so that it can not run on any CPU causes a process to be 
restricted to run on the CPU where the oncpu command was executing. 

Attempting to restrict a process to run on a nonexistent processor causes the whole 
operation to fail. That is, if the -p option is being used, the restriction operation fails. If 
no - options are being used, the command is not executed. 



FILES 



/vmunix the kernel 



SEE ALSO 

cpustatus(8), pstat(8) 
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NAME 

preinstall - check for files to save before full install of OS/MP 

SYNOPSIS 

/usr/etc/preinstall [ -I ] [ -c mmddhhmm[yy] ] 

DESCRIPTION 

The preinstall command is used to look for files that should be saved prior to doing a full 
install of a new version of OS/MP. It looks on the system partitions (root, /usr, and /var) 
for files which have been touched after the date of the last full install of OS/MP (or, if 
given a cutoff date, files touched after that date.) 

preinstall is normally used just before installing a new version of OS/MP to determine 
what system-related files should be backed up. Then, after installing the new version of 
OS/MP, you can merge or restore these files into the newly-installed system. Some files, 
such as /etc/fstab, can typically be re-used without modification. Others, such as kernel 
configuration files in /usr/kvm/sys/*/conf, must be hand-merged into the new version of 
the OS with careful consideration of how the new OS version differs from the old. 

Certain files are excluded from the output which are newer than the cutoff date. These 
files are normally updated by system operation and do not need to be backed up. Exam- 
ples of excluded files are: /etc/mtab, the /var/sadm accounting files, the /tmp_mnt auto- 
mounter directories, and patched kernel object files in /usr/kvm/sys/*/OBJ. 

By default, the cutoff date used is the modification date of the file /etc/sys_conf/system- 
configured, which is touched the first time you boot a new version of the OS after a full 
install. You may want to use some other cutoff date with the -c option if the current OS 
was installed in some nonstandard way. 

By default, the files and directories newer than the cutoff are listed to standard output by 
name, one per line. By using the -I option, the output is in long form (as from the -Is 
option to find), showing the type, date, and size of each file. 

OPTIONS 

The following options are accepted by preinstall: 

-I Present the output in long form, showing inode number, size in kilo- 

bytes (1024 bytes), protection mode, number of hard links, user, 
group, size in bytes, and modification time. If the file is a special file 
the size field will instead contain the major and minor device 
numbers. If the file Is a symbolic link the pathname of the linked-to 
file is printed preceded by '->'. The format is identical to that of find -Is. 

-c cutoff Use the given cutoff date to decide which files to print, rather than the 

date of the file /etc/sys_conf/system-configured. The cutoff date for- 
mat is -c mmddhhmm[yy], with month, day, hour, minute, and optional 
year in numeric form. This is the same format as for /usr/5bin/touch. 

SEE ALSO 

find(1),touch(1v) 

DIAGNOSTICS 

please become superuser to run this script 

The script needs to look inside system directories that are protected against 
normal users, so it must be run as super-user. 

Could not find the file /usr/etc/sys_conf/system-configured 

This file, which should have been touched during the first-time boot of the 
current version of OS/MP, is missing. You will have to use the -c option to 
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preinstall after choosing a date that reflects the last time OS/MP was 
installed. 
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NAME 



pstat - print system facts 



SYNOPSIS 

/usr/etc/pstat [ -afipSsTb ] [ -u pid] [ system [ corefile ] ] 

DESCRIPTION 

pstat interprets the contents of certain system tables. If corefile is given, the tables are 
sought there, otherwise in /dev/kmem. The required namelist is taken from /vmunix 
unless system is specified. 



OPTIONS 
-a 

-b 

-f 



Under -p, describe all process slots rather than just active ones. 

Print a stack backtrace of all processes in the system. 

Print the open file table with these headings: 

LOG The memory address of this table entry. 

TYPE The type of object the file table entry points to. 

FLG Miscellaneous state variables encoded thus: 

R open for reading 

W open for writing 

A open for appending 

S shared lock present 

X exclusive lock present 

I signal pgrp when data ready 
CNT Number of processes that know this open file. 

MSG Number of references from message queue. 

DATA The location of the vnode table entry or socket for this file. 

OFFSET The file offset (see lseek(2V)). 

Print the inode table including the associated vnode entries with these headings: 

I LOG The memory address of this table entry. 

IFLAG Miscellaneous inode state variables encoded thus: 

A inode access time must be corrected 

C inode change time must be corrected 

L inode is locked 

R inode is being referenced 

U update time (fs(5)) must be corrected 

W wanted by another process (L flag is on) 
IDEVIGE Major and minor device number of file system in which this 

inode resides. 
INO l-number within the device. 

MODE Mode bits in octal, see chmod(2V). 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZE/DEV Number of bytes in an ordinary file, or major and minor 

device of special file. 
VFLAG Miscellaneous vnode state variables encoded thus: 

R root of its file system 

S shared lock applied 

E exclusive lock applied 

Z process is waiting for a shared or exclusive 
lock 
GNT Number of open file table entries for this vnode. 

SHG Reference count of shared locks on the vnode. 
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EXC 



TYPE 



Reference count of exclusive locks on the vnode (this may 
be '> 1' if, for example, a file descriptor is inherited across 
a fork). 

Vnode file type, either VNON (no type), VREG (regular), 
VOIR (directory), VBLK (block device), VCHR (character 
device), VLNK (symbolic link), VSOCK (socket), VFIFO 
(named pipe), or VBAD (bad). 



Print process table for active processes with these headings: 



LOG 


The memory address of this table entry. 


S 


Run state encoded thus: 




no process 




1 awaiting an event 




2 (abandoned state) 




3 runnable 




4 being created 




5 being terminated 




6 stopped (by signal or under trace) 


F 


Miscellaneous state 
cimal): 


) variables, ORed together (hexade- 




0000001 


loaded 




0000002 


a system process (scheduler or 
page-out daemon) 




0000004 


locked for swap out 




0000008 


swapped out during process creation 




0000010 


process is being traced 




0000020 


tracing parent has been told that pro- 
cess is stopped 




0000040 


user settable lock in memory 




0000080 


in page-wait 




0000100 


prevented from swapping during 
fork(2V) 




0000200 


will restore old mask after taking sig- 
nal 
exiting 




0000400 




0000800 


doing physical I/O 




0001000 


process resulted from a vfork(2) 
which is not yet complete 




0002000 


another flag for vfork(2) 




0004000 


process has no virtual memory, as it 
is a parent in the context of vfork(2) 




0008000 


process is demand paging pages 
from its executable image vnode 




0010000 


process has advised of sequential VM 
behavior with vadvlse(2) 




0020000 


process has advised of random VM 
behavior with vadvise(2) 




0080000 


process is a session process group 
leader 




0100000 


process is tracing another process 




0200000 


process needs a profiling tick 




0400000 


process is scanning descriptors dur- 
ing select 




4000000 


process has done record locks 
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-S 



8000000 process is having its system calls 
traced 
PRI Scheduling priority, see getpriority(2). 

SIG Signals received (signals 1 -32 coded in bits 0-31). 

UID Real user ID. 

SLR Amount of time process has been blocked. 

TIM Time resident in seconds; times over 127 coded as 127. 

CPU Weighted integral of CPU time, for scheduler. 

Nl Nice level, see getpriority(2). 

PGRP Process number of root of process group. 

PID The process ID number. 

PPID The process ID of parent process. 

RSS Resident set size — the number of physical page frames 

allocated to this process. 
SPSS RSS at last swap (0 if never swapped). 

SIZE The size of the process image. That is, the sum of the 

data and stack segment sizes, not including the sizes of 

any shared libraries. 
WCHAN Wait channel number of a waiting process. 
LINK Link pointer in list of runnable processes. 

PAM Current process affinity bitmask. 

SPAM Saved process affinity bitmask. 

ROTOR Index of the next free list where pages will be allocated 

from when a new page is required. This is used to avoid 

cache aliasing. 

Print the streams table with these headings: 



LOG 
WRQ 
VNODE 
DEVICE 

PGRP 
SIGIO 

FLG 



The memory address of this table entry. 

The address of this stream's write queue. 

The address of this stream's vnode. 

Major and minor device number of device to which this 

stream refers. 

This stream's process group number. 

The process id or process group that has this stream 

open(). 

Miscellaneous stream state variables encoded thus: 

1 waiting for ioctl( ) to finish 
R read/recvmsg is blocked 
W write/putmsg is blocked 

P priority message is at stream head 
H device has been "hung up" (m_hangup) 
O waiting for open to finish 
M stream is linked under multiplexor 
D stream is in message-discard mode 
N stream is in message-nondiscard mode 
E fatal error has occurred (m_error) 
T waiting for queue to drain when closing 

2 waiting for previous ioctl() to finish before 
starting new one 

3 waiting for acknowledgment for ioctl( ) 
B stream is in non-blocking mode 

A stream is in asynchronous mode 
o stream uses old-style no-delay mode 
S stream has had TOSTOP set 
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-u pid 



C VTIME clock running 

V VTIME timer expired 

r collision on select() for reading 

w collision on select( ) for writing 

e collision on select( ) for exceptional condition 

The queues on the write and read sides of the stream are listed for each stream. 
Each queue is printed with these headings: 

NAME The name of the module or driver for this queue, 

COUNT The approximate number of bytes on this queue. 

FLG Miscellaneous state variables encoded thus: 

E queue is enabled to run 
R someone wants to get from this queue when it 

becomes non-empty 
W someone wants to put on this queue when it 

drains 
F queue is full 

N queue should not be enabled automatically by 
a putq 
MINPS The minimum packet size for this queue. 

MAXPS The maximum packet size for this queue, or INF if there is 

no maximum. 
HIWAT The high-water mark for this queue. 

LOWAT The low-water mark for this queue. 

Print information about swap space usage: 

allocated: The amount of swap space (in bytes) allocated to private 
pages. 

reserved: The number of swap space bytes not currently allocated, 
but claimed by memory mappings that have not yet created 
private pages. 

used: The total amount of swap space, in bytes, that is either 

allocated or reserved. 

available: The total swap space, in bytes, that is currently available 
for future reservation and allocation. 

Print the number of used and free slots in the several system tables. This is use- 
ful for checking to see how full system tables have become if the system is under 
heavy load. Shows both used and cached inodes. 

Print information about the process with ID pid. 



FILES 



/vmunix 
/dev/kmem 



namelist 

default source of tables 



SEE ALSO 

ps(1), chmod(2V), fork(2V), getpriority{2), lseek(2V), stat(2V), vadvise(2), vfork(2), 
fs(5) iostat(8), oncpu(8), vmstat(8), 

BUGS 

It would be very useful if the system recorded "maximum occupancy" on the tables 
reported by -T; even more useful if these tables were dynamically allocated. 
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NAME 

swapon - specify additional device for paging and swapping 

SYNOPSIS 

/usr/etc/swapon -a 

/usr/etc/swapon 

/usr/etc/swapon -w name. . . 

DESCRIPTION 

swapon specifies additional devices or files on wliich paging and swapping are to take 
place. The system begins by swapping and paging on only a single device so that only 
one disk is required at bootstrap time. Calls to swapon normally occur in the system 
multi-user initialization file /etc/rc making all swap devices available, so that the paging 
and swapping activity is interleaved across several devices. 

The second form gives individual block devices or files as given in the system swap 
configuration table. The call makes only this space available to the system for swap allo- 
cation. 

Note: "swap files" made with mkfile(8) can be used as swap areas over NFS. 

OPTIONS 

-a Make available all devices of type swap in /etc/fstab. Using swapon with the -a 

option is the normal usage. 

-w Reports the names of the device special files which are currently being used as 
swap devices. Partitions are reported one per line. 

FILES 

/dev/sd?b 

/dev/xy?b 

/dev/xd?b normal paging devices 

/etc/fstab 

/etc/rc 

SEE ALSO 

swapon(2), fstab(5), init(8), mkfile(8) 

BUGS 

There is no way to stop paging and swapping on a device. It is therefore not possible to 
make use of devices which may be dismounted during system operation. 
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NAME 

vmstat - report virtual memory statistics 

SYNOPSIS 

vmstat [ -f isSp ] [ interval [ count ] ] 

DESCRIPTION 

vmstat delves into the system and normally reports certain statistics kept about process, 
virtual memory, disk, trap and CPU activity. 

Without options, vmstat displays a one-line summary of the virtual memory activity since 
the system has been booted. If interval \s specified, vmstat summarizes activity over the 
last /nte/va/ seconds. If a count \s given, the statistics are repeated count Wmes. 

For example, the following command displays a summary of what the system is doing 
every five seconds. This is a good choice of printing interval since this is how often some 
of the statistics are sampled in the system. 
example % vmstat 5 

procs memory page faults 

r b w avm fre re at pi po fr de sr xO xl x2 x3 in sy cs us sy id 
200 918 286 000000 01000 4 12 535 91 
100 846 254 6 1 42 153 31 7 40 54 
10 840 268 5 27 103 25 8 26 66 
1 620 312 6 26 76 25 6 27 67 

CTRL-C 

example% 

The fields of vmstat's display are: 

procs Report the number of processes in each of the three following states: 
r in run queue 

b blocked for resources (i/o, paging, etc.) 

w runnable or short sleeper (< 20 sees) but swapped 

memory 

Report on usage of virtual and real memory. Virtual memory is considered 

active if it belongs to processes which are running or have run in the last 20 

seconds. 

avm number of active virtual Kbytes 

fre size of the free list in Kbytes 

page Report information about page faults and paging activity. The information on 
each of the following activities is averaged each five seconds, and given in units 
per second. 

re page reclaims — but see the -S option for how this field is modified. 

at number of attaches — but see the -S option for how this field is 

modified. 
pi kilobytes per second paged in 

po kilobytes per second paged out 

fr kilobytes freed per second 

de anticipated short term memory shortfall in Kbytes 

sr pages scanned by clock algorithm, per-second 

disk Report number of disk operations per second (this field is system dependent). 
For Solbourne systems, four slots are available for up to four drives: "xO" (or 
"SO" for SCSI disks), "x1", "x2", and "x3". 

faults Report trap/interrupt rate averages per second over last 5 seconds. 
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in (non clock) device interrupts per second 

sy system calls per second 

cs CPU context switch rate (switches/sec) 

cpu Give a breakdown of percentage usage of CPU time. 

us user time for normal and low priority processes 

sy system time 

id CPU idle 

pliit Percentage of the time the context switch of a process resumes on the 
same processor where it last executed (-p) option. 

OPTIONS 

-f Report on the number of forks and vforl<s since system startup and the number 

of pages of virtual memory involved in each kind of fork. 

-i Report the number of interrupts per device. Autovectored interrupts (including 

the clock) are listed first. 

-s Display the contents of the sum structure, giving the total number of several 

kinds of paglng-related events which have occurred since boot. 

-S Report on swapping rather than paging activity. This option will change two 
fields in vmstat's "paging" display: rather than the "re" and "at" fields, vmstat 
will report "si" (swap-ins), and "so" (swap-outs). 

-p Displays how often a context switch of a process resumes on the same proces- 

sor rather than the normal CPU statistics. 



FILES 



/dev/kmem 
/vmunix 



BUGS 

If more than one autovectored device has the same name, interrupts are counted for all 
like-named devices regardless of unit number. Such devices are listed with a unit 
number of '?'. 
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